infyicon-mcp
Search and retrieve 161,000+ free Infyicon vector icons from AI assistants — get SVG markup, PNG URLs, related icons, categories, and UI font classes.
Search icons by keyword with style filter and paging
Get popular/featured icons when no search term is given
Find related icons on the same theme for matching sets or variations
Fetch ready-to-embed SVG markup for a single icon
Get SVG markup for 1–20 icons in one bulk call
Generate transparent PNG URLs at 16–512 px for an icon
List popular icon categories with counts and URLs
Search the 61,000-glyph UI webfont for CSS class names like "ii-r-home"
Integrates with GitHub Copilot to provide icon search and retrieval for SVG/PNG assets directly in the coding workflow.
Allows JetBrains IDEs to access Infyicon's icon search and retrieval tools for embedding vector or raster icons in projects.
Provides Perplexity with the ability to search and retrieve Infyicon icons, including SVG markup and PNG URLs, for use in responses.
Infyicon MCP Server
Search 161,000+ free hand-drawn vector icons from any AI assistant — Claude, ChatGPT, Cursor, VS Code / Copilot, Codex, Gemini, Windsurf, Zed, Cline, Goose, LM Studio, JetBrains and every other MCP client. Four matching styles (outline, fill, color-outline, color-fill), ready-to-embed SVG markup, transparent PNGs at 16–512 px, and a 61,000-glyph UI webfont.
Hosted endpoint (recommended):
https://infyicon.com/mcp— streamable HTTP, stateless, no auth, no API key, every tool read-onlyOne-click install buttons + copy-paste config for every client: https://infyicon.com/connect
Icon license: free for personal & commercial use with attribution to infyicon.com — https://infyicon.com/license
Tools (v1.2.0)
Tool | What it does |
| Keyword search over 161,000+ icons, optional style filter, offset paging. Returns ids, names, page/SVG/PNG URLs, tags. |
| Featured icons when there is no search term. |
| Same-theme icons across styles — build a matching set or offer variations. |
| Full ready-to-embed SVG markup for one icon id. |
| SVG markup for 1–20 icon ids in one call. |
| Transparent PNG URLs at 16 / 24 / 32 / 64 / 128 / 256 / 512 px. |
| Most popular categories with counts and category-page URLs. |
| CSS class names in the Infyicon UI webfont ( |
Old names from v1.0/1.1 (popular_icons, related_icons, bulk_svg, uicons_lookup) are still accepted as aliases.
Related MCP server: brain-mcp-icon-visual
Quick start
Claude.ai / Claude Desktop — Settings → Connectors → Add custom connector → https://infyicon.com/mcp. Or install the desktop extension: infyicon.mcpb.
Claude Code
claude mcp add --transport http infyicon https://infyicon.com/mcp
# or as a plugin
claude plugin marketplace add krupalghori44-dev/infyicon-mcp && claude plugin install infyicon@infyiconChatGPT — Settings → Apps & Connectors → Advanced → Developer mode → Create → MCP URL https://infyicon.com/mcp, auth None.
Cursor — Add to Cursor or ~/.cursor/mcp.json:
{ "mcpServers": { "infyicon": { "url": "https://infyicon.com/mcp" } } }VS Code / GitHub Copilot — .vscode/mcp.json:
{ "servers": { "infyicon": { "type": "http", "url": "https://infyicon.com/mcp" } } }Codex CLI — codex mcp add infyicon --url https://infyicon.com/mcp
Gemini CLI (extension, recommended) — gemini extensions install https://github.com/krupalghori44-dev/infyicon-mcp — adds the server, a /icons <query> command and usage context. Or plain MCP: gemini mcp add --transport http infyicon https://infyicon.com/mcp · Gemini app — Settings → Connected apps → Add custom MCP server
Windsurf — { "mcpServers": { "infyicon": { "serverUrl": "https://infyicon.com/mcp" } } }
Cline / Roo Code — { "mcpServers": { "infyicon": { "type": "streamableHttp", "url": "https://infyicon.com/mcp" } } }
Any stdio-only client (Zed, Goose, LM Studio, JetBrains, Perplexity…) — the zero-dependency npm bridge relays to the hosted server:
{ "mcpServers": { "infyicon": { "command": "npx", "args": ["-y", "infyicon-mcp"] } } }Run it yourself
npx -y infyicon-mcp # stdio bridge
npx -y infyicon-mcp --http 3000 # local HTTP mirror at POST http://127.0.0.1:3000/mcp
docker build -t infyicon-mcp . && docker run -i infyicon-mcpstandalone.js relays initialize, tools/list and tools/call to https://infyicon.com/mcp (override with INFYICON_MCP_UPSTREAM), so it never goes stale. mcp.js is the reference implementation that runs on infyicon.com (Express, hand-rolled JSON-RPC, no SDK).
Repository layout
standalone.js— npm packageinfyicon-mcp(stdio /--http)mcp.js— hosted server sourcemcpb/— Claude Desktop extension source; build withnpx @anthropic-ai/mcpb pack mcpb dist/infyicon.mcpb.claude-plugin/+.mcp.json— Claude Code plugin marketplacegemini-extension.json+GEMINI.md+commands/— Gemini CLI extension (/iconscommand)connect/connect.html— the one-click setup page served at https://infyicon.com/connectserver.json— Official MCP Registry manifest
Privacy
Tool arguments (search words, icon ids, style filters) are sent to infyicon.com over HTTPS; responses contain icon metadata, SVG markup and PNG URLs. No account, API key, telemetry or local file access. Privacy policy: https://infyicon.com/privacy · Contact: info@infyicon.com
License
Server and bridge code: MIT. Icons: free with attribution — https://infyicon.com/license
Available Tools
8 toolsget_icon_pngGet icon PNG URLsARead-onlyIdempotentInspect
Return direct PNG download URLs (transparent background) for one Infyicon icon id, either a single size or all seven sizes 16/24/32/64/128/256/512 px. Use when the user needs an image file or src (email, docs, chat, platforms that cannot render SVG); use get_icon_svg instead when inline vector markup is wanted. Read-only, no auth; returns URLs only (no binary data); returns an error for a malformed id or an unknown icon. Free with attribution to infyicon.com.
Inputs: id (required), size.
get_icon_svgGet icon SVGARead-onlyIdempotentInspect
Return the full, ready-to-embed SVG markup of ONE Infyicon icon by id (slug_number, e.g. hammer-16_66091 - get ids from search_icons). Use when the user wants inline SVG for a single icon; use get_icon_svg_bulk for 2-20 icons in one call, and get_icon_png when they need a raster image URL instead of markup. Read-only, no auth; returns an error for a malformed id or an unknown icon; if the SVG is over 200 KB the response carries svg_url instead of inline markup. Free with attribution to infyicon.com.
Inputs: id (required).
get_icon_svg_bulkGet SVG for several iconsARead-onlyIdempotentInspect
Return ready-to-embed SVG markup for 1-20 Infyicon icons in one call (pass an array of ids from search_icons). Use when building a UI, icon set or design system so you fetch several icons at once instead of calling get_icon_svg repeatedly; use get_icon_svg for a single icon. Read-only, no auth; ids beyond the first 20 are silently dropped; each bad or unknown id gets a per-item error while the rest still succeed; oversized SVGs (>200 KB) return svg_url instead of markup. Free with attribution to infyicon.com.
Inputs: ids (required).
get_popular_iconsGet popular iconsARead-onlyIdempotentInspect
Return up to 30 popular/featured Infyicon icons (ids, names, styles, page/SVG/PNG URLs) without a search query - use when the user just wants "a nice icon" or a starting set and has not named a subject. Use search_icons instead when the user describes a subject, and get_related_icons instead when they already have an icon and want variations. Read-only, no auth; always returns results (never errors on empty input). Free with attribution to infyicon.com.
Inputs: limit, style.
list_categoriesList icon categoriesARead-onlyIdempotentInspect
List the most popular Infyicon icon categories (name, slug, icon count, category page URL at https://infyicon.com/free-icons/), ordered by popularity. Use to browse or suggest topics before searching, or to link the user to a category page; use search_icons to actually fetch icons for a topic. Read-only, no auth; no pagination (limit up to 100). Free with attribution to infyicon.com.
Inputs: limit.
search_iconsSearch iconsARead-onlyIdempotentInspect
Search 161,000+ free Infyicon vector icons by keyword and return up to 30 matches per page, each with icon id (slug_number), name, style, page URL, direct SVG URL, 512px PNG URL and tags. Styles: outline (black line), fill (black solid), color-outline, color-fill. Use this first whenever the user describes what icon they want; then pass an id to get_icon_svg, get_icon_svg_bulk or get_icon_png. Use get_popular_icons instead when there is no search term, and search_uicons instead when the user wants a CSS webfont class rather than an SVG/PNG file. Read-only, no auth, no API key; empty query returns an error; total_matches + next_offset are returned for paging. Free with attribution to infyicon.com.
Inputs: query (required), limit, style, offset.
search_uiconsSearch UI webfont classesARead-onlyIdempotentInspect
Search the Infyicon UI webfont (61,000+ glyphs) by glyph name and return matching CSS class names (regular ii-r-, solid ii-s-) plus a ready tag and the stylesheet link https://infyicon.com/uicons/uicons.css. Use ONLY when the user wants an icon font / CSS class (like Font Awesome usage); use search_icons for SVG or PNG icon files. Case-insensitive substring match, up to 40 matches, no pagination; empty name returns an error. Read-only, no auth. Free with attribution to infyicon.com.
Inputs: name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct mode: keyword search, popular browsing, related suggestions, single SVG, bulk SVG, PNG URLs, category listing, and font-class search. Cross-references in descriptions ('use X instead when...') make selection unambiguous.
All tools follow a clear verb_noun snake_case pattern: search_*, get_*, list_*. Retrieval variants (get_icon_svg, get_icon_svg_bulk, get_icon_png) form a predictable family.
Eight tools is well-scoped for an icon library: three discovery tools, four retrieval/format tools, and one category browser. Each serves a distinct workflow without bloat.
The surface covers the full read-only icon workflow: search/discover, browse popular/related/categories, fetch single or bulk SVG, fetch PNG URLs, and access the webfont. No obvious dead ends for the stated domain.
Maintenance
Related MCP Connectors
Search and fetch 450,000+ free SVG icons and brand logos from 270+ open-source icon sets.
Search and fetch hand-drawn icons, illustrations and isometric drawings. The free set needs no key.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Search free MIT SVG icons and paste React, Vue, Svelte or SVG code. No auth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to over 200,000 open-source vector icons from more than 200 icon sets via the Iconify API. It enables users to browse, search, and retrieve specific icon data along with usage examples for popular web frameworks like React, Vue, and Tailwind CSS.426 npm22GPL 3.0
- FlicenseNot gradedqualityDmaintenanceVisual icon search, retrieval, and comparison for AI agents. Search 200k+ icons semantically, render side-by-side comparison grids, and retrieve raw SVG markup — all tools return images so vision-capable LLMs can see the icons.1-
- AlicenseAqualityDmaintenanceProvides access to Iconify's 200,000+ open source vector icons from 200+ icon sets, enabling search, browsing, and retrieval of icon data with framework usage examples.412 npmMIT
- AlicenseCqualityDmaintenanceEnables AI-powered icon search, generation, and download from 275,000+ icons with web-based authentication and subscription plans.15 npmMIT