Click any result to copy its URL. Powered by the same /api/search endpoint agents use.
Embed an icon (fastest path)
Drop this URL into an <img>, a markdown image, or fetch it. No signup.
<img src="https://YOUR_HOST/i/home.svg" />
https://YOUR_HOST/i/shopping-cart.svg?color=%23e11d48&size=48
https://YOUR_HOST/icons/lucide/house.svg?stroke=1.5
https://YOUR_HOST/i/github.svg?format=png&size=128Query parameters
| param | values | example |
|---|---|---|
color | hex, CSS color, or currentColor | color=%23ff0000 |
size | 1–2048 (px) | size=64 |
stroke | 0–20 (line icons) | stroke=1.5 |
style | e.g. solid, filled | style=solid |
format | svg or png | format=png&size=128 |
For AI agents
Machine-readable docs live at /llms.txt. Three ways in:
- Guessable URLs —
/i/{name}.svg(best match) or/icons/{set}/{name}.svg. - JSON API —
/api/search?q=…,/api/icon,/api/sets. OpenAPI at/openapi.json. - MCP server — connect an MCP client to
/mcp. Tools:search_icons,get_icon,list_sets.
Licensing
IconServe preserves collection-level license metadata and exposes it through /api/sets and MCP results. The catalog combines the official Iconify archive with locally mirrored open-source sets. Brand marks remain trademarks of their respective owners.
How the directory is measured
As of August 5, 2026, the machine-readable inventory contains 366,298 distinct icon IDs across 240 collections. The count is generated from the installed upstream collection data, aliases, and non-overlapping locally hosted IDs; inspect the current totals and licenses at /api/sets.
Frequently asked questions
What is IconServe?
IconServe is a free, MCP-native icon directory for AI agents and developers. It exposes 366,298 icon IDs from 240 open-source collections through MCP, HTTP, SVG and PNG endpoints.
Does IconServe require an API key?
No. IconServe is free to access and does not require registration or an API key.
How can an AI agent search IconServe?
Connect an MCP client to https://icons-for-agents.site/mcp and call search_icons, or use /api/search?q=… over HTTP.
Are the icons free to use?
The directory aggregates open-source collections and returns the applicable collection license. Review that license before use, especially for trademarks and brand icons.