Skip to main content
Glama

Infyicon MCP Server

Official MCP Registry npm Glama TDQS One-click setup

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.

Tools (v1.2.0)

Tool

What it does

search_icons

Keyword search over 161,000+ icons, optional style filter, offset paging. Returns ids, names, page/SVG/PNG URLs, tags.

get_popular_icons

Featured icons when there is no search term.

get_related_icons

Same-theme icons across styles — build a matching set or offer variations.

get_icon_svg

Full ready-to-embed SVG markup for one icon id.

get_icon_svg_bulk

SVG markup for 1–20 icon ids in one call.

get_icon_png

Transparent PNG URLs at 16 / 24 / 32 / 64 / 128 / 256 / 512 px.

list_categories

Most popular categories with counts and category-page URLs.

search_uicons

CSS class names in the Infyicon UI webfont (<i class="ii-r-home"></i>).

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@infyicon

ChatGPT — 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-mcp

standalone.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 package infyicon-mcp (stdio / --http)

  • mcp.js — hosted server source

  • mcpb/ — Claude Desktop extension source; build with npx @anthropic-ai/mcpb pack mcpb dist/infyicon.mcpb

  • .claude-plugin/ + .mcp.json — Claude Code plugin marketplace

  • gemini-extension.json + GEMINI.md + commands/ — Gemini CLI extension (/icons command)

  • connect/connect.html — the one-click setup page served at https://infyicon.com/connect

  • server.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 tools
get_icon_pngGet icon PNG URLsA
Read-onlyIdempotent
Inspect

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 SVGA
Read-onlyIdempotent
Inspect

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 iconsA
Read-onlyIdempotent
Inspect

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).

list_categoriesList icon categoriesA
Read-onlyIdempotent
Inspect

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 iconsA
Read-onlyIdempotent
Inspect

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 classesA
Read-onlyIdempotent
Inspect

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

    A4.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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 npm
      22
      GPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Visual 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      12 npm
      MIT