io.github.krupalghori44-dev/infyicon-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search 161,000+ free icons; get SVG (single/bulk), PNG, related icons, webfont classes. No API key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "infyicon-mcp": {
      "url": "https://infyicon.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• search_icons read-only

  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.

  Parameters:

  • query (required) — string — What to search for, e.g. "shopping cart", "doctor", "hammer" (1-4 plain words work best)
  • limit — integer — Max results per page (default 10, max 30)
  • style — string — Optional: restrict to one style; omit to get all four styles mixed
  • offset — integer — Optional: skip this many results for pagination. Pass next_offset from the previous response to get the next page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_popular_icons read-only

  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.

  Parameters:

  • limit — integer — Max results (default 12, max 30)
  • style — string — Optional: restrict to one style

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_related_icons read-only

  Given one icon id (from search_icons or get_popular_icons), return up to 30 related Infyicon icons on the same theme in the same and other styles - use for offering variations, alternatives or building a matching icon set. Use search_icons instead when you do not yet have an id. The source icon itself is excluded from results. Read-only, no auth; returns an error if the id is not in slug_number format. Free with attribution to infyicon.com.

  Parameters:

  • id (required) — string — Icon id like hammer-16_66091 (slug_number, as returned by search_icons)
  • limit — integer — Max results (default 12, max 30)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_icon_svg read-only

  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.

  Parameters:

  • id (required) — string — Icon id like hammer-16_66091 (slug_number)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_icon_svg_bulk read-only

  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.

  Parameters:

  • ids (required) — array — Array of 1-20 icon ids, e.g. ["home-2_101", "gear-1_202"]

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_icon_png read-only

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

  Parameters:

  • id (required) — string — Icon id like hammer-16_66091 (slug_number)
  • size — integer — Optional single size in px; omit to get all seven sizes

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_categories read-only

  List the most popular Infyicon icon categories (name, slug, icon count, category page URL at https://infyicon.com/free-icons/<slug>), 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.

  Parameters:

  • limit — integer — Max categories (default 30, max 100)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_uicons read-only

  Search the Infyicon UI webfont (61,000+ glyphs) by glyph name and return matching CSS class names (regular ii-r-<name>, solid ii-s-<name>) plus a ready <i> 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.

  Parameters:

  • name (required) — string — Glyph name or part of it to search, e.g. "home", "arrow"

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.