Icons for AI agents

IconServe is the icon library for agentic development — a free, open-source SVG icon API your AI agents can search and embed. 10,000+ icons at predictable URLs — no API key, an MCP icon server, and an llms.txt so models like ChatGPT, Claude, Gemini and Grok can use it directly.

Search 10,000+ icons Add to your AI agent Read the llms.txt

Three ways an AI agent can get an icon

Every method returns the same catalog of agent-readable icons — pick whichever fits your stack.

1. Predictable URL (no API key)

Fetch any icon as SVG or PNG. Recolor and resize with query parameters:

https://icons-for-agents.site/i/home.svg
https://icons-for-agents.site/i/heart.svg?color=%23e11d48&size=48
https://icons-for-agents.site/i/bell.svg?format=png&size=128

2. JSON API with natural-language search

Semantic + keyword search returns names and ready-to-use SVG URLs:

GET https://icons-for-agents.site/api/search?q=notification%20bell&limit=3

3. MCP icon server

A remote Model Context Protocol server over streamable HTTP, exposing search_icons, get_icon, and list_sets:

# Claude Code
claude mcp add --transport http iconserve https://icons-for-agents.site/mcp

Why it's built for agents, not just humans

• No API key, no sign-up — agents can call it the moment they discover it.
• Predictable, guessable URLs — /i/{name}.svg needs no lookup.
• llms.txt + OpenAPI — the whole API in one machine-readable file.
• Semantic search — find icons by meaning, not exact keywords.
• Open-source & free — 10,000+ icons from Lucide, Heroicons, Tabler and Simple Icons.

Frequently asked questions

Is there an icon API with no API key?

Yes. IconServe is a free SVG icon API with no API key, no sign-up, and no rate-limit registration. Request any icon at a predictable URL such as https://icons-for-agents.site/i/home.svg and get back raw SVG (or PNG with ?format=png). CORS is open, so you can call it directly from a browser, a Worker, or an AI agent.

How do I add IconServe as an MCP icon server to Claude or ChatGPT?

IconServe runs a remote Model Context Protocol (MCP) server at https://icons-for-agents.site/mcp over streamable HTTP. In Claude Code, run: claude mcp add --transport http iconserve https://icons-for-agents.site/mcp . Any MCP-compatible client (Claude, Cursor, and others) can connect and call the search_icons, get_icon, and list_sets tools.

What is llms.txt and does IconServe have one?

llms.txt is a plain-text file that describes a site's API in a way large language models can read in one request. IconServe serves the full API at https://icons-for-agents.site/llms.txt (and an expanded https://icons-for-agents.site/llms-full.txt), so an AI agent can learn every endpoint, parameter, and example without scraping HTML.

Can AI agents search icons by natural language?

Yes. The search endpoint combines keyword matching with semantic (embedding) search, so an agent can ask for vague concepts like “something to buy stuff with” and get shopping-cart icons back. Try https://icons-for-agents.site/api/search?q=notification+bell.

Which open-source icon sets are included?

IconServe aggregates 10,000+ icons from Lucide (ISC), Heroicons (MIT), Tabler (MIT), and Simple Icons (CC0) into one agent-readable catalog, each served at a predictable URL with its original license preserved.