infyicon mcp

Infyicon MCP Server

Search 161,000+ free hand-drawn vector icons from any MCP client — Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Codex, Gemini CLI, Windsurf and more. Every icon comes in four matching styles (outline, fill, color-outline, color-fill) with ready-to-embed SVG markup and PNG URLs at 16–512 px.

• Hosted endpoint (recommended): https://infyicon.com/mcp — streamable HTTP, stateless, no auth, no API key
• Setup guide with copy-paste config for every client: https://infyicon.com/developers
• Icon license: free for personal & commercial use with attribution to infyicon.com — see https://infyicon.com/license

Tools

Tool	What it does
search_icons	Search 161,000+ icons by keyword, optionally filtered to one of the four styles. Returns ids, page URLs, SVG + PNG URLs, tags.
get_icon_svg	Full SVG markup for an icon id — ready to embed in HTML/JSX/design tools.
get_icon_png	Direct transparent-PNG URLs (16, 24, 32, 64, 128, 256, 512 px) for an icon id.
list_categories	Most popular icon categories with counts and category-page URLs.
uicons_lookup	Look up CSS classes in the Infyicon UI webfont (61,000+ glyphs, <i class="ii-r-home"></i>).

Quick start — hosted endpoint

Claude Code

claude mcp add --transport http infyicon https://infyicon.com/mcp

Claude Desktop / claude.ai — Settings → Connectors → Add custom connector → URL https://infyicon.com/mcp

Cursor / VS Code / Windsurf (mcp.json)

{
  "mcpServers": {
    "infyicon": { "url": "https://infyicon.com/mcp" }
  }
}

Codex CLI (~/.codex/config.toml)

[mcp_servers.infyicon]
url = "https://infyicon.com/mcp"

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "infyicon": { "httpUrl": "https://infyicon.com/mcp" }
  }
}

Full, always-current instructions for all clients: https://infyicon.com/developers

Run locally (stdio)

standalone.js is a zero-dependency Node 18+ entry point. It answers initialize / tools/list locally and relays tools/call to the hosted endpoint (where the search index and 161k SVG assets live).

git clone https://github.com/krupalghori44-dev/infyicon-mcp.git
node infyicon-mcp/standalone.js          # MCP over stdio
node infyicon-mcp/standalone.js --http 3000   # or streamable HTTP at :3000

Client config for the stdio version:

{
  "mcpServers": {
    "infyicon": { "command": "node", "args": ["/path/to/infyicon-mcp/standalone.js"] }
  }
}

Docker

docker build -t infyicon-mcp .
docker run -i infyicon-mcp

Repo layout

• standalone.js — zero-dependency stdio/HTTP server (local bridge; what the Dockerfile runs)
• mcp.js — the production Express module that serves https://infyicon.com/mcp (reference; depends on server-side assets)
• Dockerfile — builds the standalone bridge

Example

"Find me a shopping cart icon in outline style and give me the SVG."

The client calls search_icons {"query":"shopping cart","style":"outline"}, picks an id like shopping-cart-12_10432, then get_icon_svg returns the full markup to paste straight into your project.

License

Code in this repository: MIT. Icons served by the API remain free for personal and commercial use with attribution to infyicon.com — details at https://infyicon.com/license.