# IconServe — icons for agentic development

> The icon library for agentic development: 10,137 open-source icons (heroicons, lucide, simple-icons, tabler) your AI agents can search and embed as SVG or PNG.
> Every icon is reachable at a predictable URL. Recolor, resize, and re-stroke via query params.
> No API key. CORS is open. Responses are cacheable and immutable.

## Fastest path (embed an icon directly)

Put this URL in an <img>, markdown image, or fetch it:

  https://icons-for-agents.site/i/{name}.svg

Examples:
  https://icons-for-agents.site/i/home.svg
  https://icons-for-agents.site/i/shopping-cart.svg?color=%23e11d48&size=48
  https://icons-for-agents.site/i/github.svg?color=white          (brand icon)
  https://icons-for-agents.site/i/heart.svg?stroke=1.5&color=crimson

If you are not sure of the exact icon name, SEARCH FIRST (see below) — do not guess.

## Naming

- Names are lowercase, hyphenated: "shopping-cart", "arrow-right", "chevron-down".
- /i/{name} returns the best match across all sets (priority: lucide,heroicons,tabler,simple-icons).
- To pin a specific set: /icons/{set}/{name}.svg  e.g. https://icons-for-agents.site/icons/lucide/house.svg
- Sets: heroicons, lucide, simple-icons, tabler. Brand/logo icons (companies, tools) are in "simple-icons".

## Query parameters (work on any icon URL)

- color=<hex|css-color|currentColor>   e.g. color=%23ff0000, color=red, color=currentColor
- size=<1..2048>                       pixel width/height, e.g. size=64
- stroke=<0..20>                       stroke width, line icons only, e.g. stroke=1.5
- style=<style>                        e.g. style=solid (heroicons), style=filled (tabler)
- format=svg|png                       png rasterizes server-side, e.g. format=png&size=128

## Search (use this to find the right icon)

GET https://icons-for-agents.site/api/search?q=<query>&limit=<n>&set=<optional>
  -> JSON: { query, count, results: [ { id, name, set, title, svg_url, styles, tags } ] }
  Combines keyword + semantic search, so vague queries work ("thing to buy stuff" -> shopping-cart).

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

## JSON API

- GET /api/search?q=&limit=&set=      search icons
- GET /api/icon?name=&set=&style=     one icon as JSON (includes raw svg + metadata + urls)
- GET /api/sets                       list icon sets, counts, licenses
- GET /api/manifest                   full catalog (names, sets, tags) — large

## MCP server (for MCP-capable agents)

Streamable-HTTP MCP endpoint:  https://icons-for-agents.site/mcp
Tools: search_icons(query, limit?, set?), get_icon(name, set?, style?, color?, size?, stroke?, format?), list_sets()

## Per-icon pages

Every icon has a crawlable HTML page with preview, usage, and JSON-LD structured data:
  https://icons-for-agents.site/icon/{set}/{name}   e.g. https://icons-for-agents.site/icon/lucide/house

## Machine docs

- [OpenAPI](https://icons-for-agents.site/openapi.json): full REST spec (OpenAPI 3.1).
- [llms-full.txt](https://icons-for-agents.site/llms-full.txt): expanded docs with set inventory and a worked example.
- [Sitemap](https://icons-for-agents.site/sitemap.xml): all 10,137 icon pages (and [sitemap.md](https://icons-for-agents.site/sitemap.md)).
- [Robots](https://icons-for-agents.site/robots.txt): crawl rules (AI bots welcome).
- [API catalog](https://icons-for-agents.site/.well-known/api-catalog): RFC 9727 linkset.
- [MCP server card](https://icons-for-agents.site/.well-known/mcp/server-card.json): MCP discovery.
- [Agent skills](https://icons-for-agents.site/.well-known/agent-skills/index.json): skill discovery index.
- [AGENTS.md](https://icons-for-agents.site/AGENTS.md): agent-oriented project guide.

## Licensing

Icons are redistributed under their original permissive licenses (Lucide: ISC, Heroicons: MIT,
Tabler: MIT, Simple Icons: CC0). Brand icons from Simple Icons represent third-party trademarks
owned by their respective companies; use them per each brand's guidelines.