Add IconServe to OpenAI Agents SDK

IconServe gives OpenAI Agents SDK access to 10,000+ open-source icons (Lucide, Heroicons, Tabler, Simple Icons) as SVG or PNG — searchable by name or natural language. Free, no API key.

Define a function tool that searches IconServe

from agents import Agent, function_tool
import requests

@function_tool
def find_icon(query: str) -> str:
    """Find an icon by name or description; returns a ready-to-use SVG URL."""
    r = requests.get("https://icons-for-agents.site/api/search", params={"q": query, "limit": 1}).json()
    return r["results"][0]["svg_url"] if r["results"] else "no icon found"

agent = Agent(name="UI helper", tools=[find_icon])

Try it

Ask your agent: "use iconserve to find a settings icon." It will call search_icons and return ready-to-use SVG URLs.

OpenAI Agents SDK MCP docs →