Supericons

curlymolelabs/supericons

This is semantic icon search that lets your agent find SVG icons by meaning instead of filename. It exposes four tools: search_icons for querying 20,000+ free icons by description or concept, recommend_icons for getting contextual suggestions for UI slots like nav bars or dashboards, get_icon for retrieving raw SVG code, and list_libraries to see what's available. Runs via npx with the scoped @supericons/mcp package or connects to a hosted endpoint at mcp.supericons.dev. You'd reach for this when building interfaces and you want the agent to pick appropriate icons without manually browsing libraries or guessing filenames.

GitHub stars: 2
tools: 5
transport: STDIO, HTTP
last updated: Jul 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.supericons.dev/mcp --name supericons

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http supericons https://mcp.supericons.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 5 tools

Verified live against the running server on Nov 6, 2026.

search_iconsUse this as the main icon tool. Search 20,000+ curated SVG icons across 11 libraries by meaning, label, visual description, tags, and synonyms. When matches exist, the response includes a paste-ready suggested answer, a direct preview image, and Markdown that can show the imag...7 params

Use this as the main icon tool. Search 20,000+ curated SVG icons across 11 libraries by meaning, label, visual description, tags, and synonyms. When matches exist, the response includes a paste-ready suggested answer, a direct preview image, and Markdown that can show the imag...

Parameters* required

include_query_frameboolean

Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.default: false

librarystring

Optional library key only when the user named a library. Omit it to search all libraries. Do not use all as a library key. Supported values include si (Supericons AI and developer tool logos), luci...

library_modevalue

Optional library behavior. Omit a self-chosen library and search all, or use prefer with that library. Use strict only when the user explicitly requires the named library. All searches every eligib...

limitnumber

Maximum number of icons from 1 to 50. Numeric strings are accepted.default: 10

localevalue

Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning.

query*string

Icon concept or search phrase, for example "database", "user profile", "chill", "trash", "upload cloud", "AI model", or "beautiful".

stylevalue

Optional style preference. Unsupported values are ignored with a warning.default: any

recommend_iconsRecommend a coherent icon set for up to 20 named UI slots in one call. Uses task context to narrow ambiguous meanings. When context is insufficient, returns needs_clarification with labeled interpretation options instead of guessing. Invalid inputs and service failures return...8 params

Recommend a coherent icon set for up to 20 named UI slots in one call. Uses task context to narrow ambiguous meanings. When context is insufficient, returns needs_clarification with labeled interpretation options instead of guessing. Invalid inputs and service failures return...

Parameters* required

include_query_frameboolean

Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.default: false

libraryvalue

Optional library key when the user wants a consistent icon family. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ion...

limit_per_slotnumber | string

Number of choices per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted.default: 3

localevalue

Optional locale for multilingual slot labels. Unsupported values are ignored with a warning.

response_modevalue

Response size mode: plan, assets, or full. Unsupported values use plan with a warning.default: plan

slotsarray

List of 1 to 20 UI slots to fill, for example ["model", "prompt", "dataset", "evaluation"]. A single string is accepted as one slot. Lists of up to a few hundred slots return a structured split ins...

stylevalue

Optional style preference. Unsupported values are ignored with a warning.default: any

taskstring

Overall UI task, for example "choose icons for an AI dashboard sidebar" or "select bottom navigation icons for a finance app". Missing task text returns a structured recovery message.default:

get_iconRetrieve one exact SVG icon using an exact ref returned by search_icons, recommend_icons, or preview_icons. Do not guess icon IDs. Use search_icons first if the user only described a concept. Returns SVG code, explicit public library labels, visual preview URL, and public sema...3 params

Retrieve one exact SVG icon using an exact ref returned by search_icons, recommend_icons, or preview_icons. Do not guess icon IDs. Use search_icons first if the user only described a concept. Returns SVG code, explicit public library labels, visual preview URL, and public sema...

Parameters* required

id*string

Exact icon ID without the library prefix, for example "database", "user-circle", "brain-circuit", or "arrow-down".

library*string

Required library key for the exact icon. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleico...

stylestring

Optional style preference. Material Symbols supports outline and solid. Other hosted libraries report their verified styles in list_libraries.one of any · outline · soliddefault: any

preview_iconsRefine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Icon lists up to 100 refs are accepted and safely truncated to 12. Returns ready-to-use Markdown, a hosted preview fallback, a direct PNG...7 params

Refine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Icon lists up to 100 refs are accepted and safely truncated to 12. Returns ready-to-use Markdown, a hosted preview fallback, a direct PNG...

Parameters* required

icon_refsarray

Optional fixed icon refs in library:id format. Arrays, a single ref, and comma-separated refs are accepted. Up to 100 are accepted, 24 appear on the browser preview, and 12 are rendered inline. Sen...

include_imageboolean

When true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned.default: true

libraryvalue

Optional library key. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons br...

limitnumber | string

Requested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted.default: 12

localevalue

Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning.

querystring

Optional search query to preview visually, for example "license plate recognition camera scan car".

stylevalue

Optional style preference. Unsupported values are ignored with a warning.default: any

list_librariesList the free icon libraries available through the hosted Supericons MCP server. Use this before filtering by library or when a user asks which icon libraries are supported.

List the free icon libraries available through the hosted Supericons MCP server. Use this before filtering by library or when a user asks which icon libraries are supported.

No parameters. Call it with no arguments.

Readme

Supericons v2.0

Semantic SVG icon search, previews, and recommendations for AI coding agents.

Supericons helps agents find icons by meaning, not only by file name. It searches 20,000+ free icons across 11 libraries and can return SVG code or a visual comparison.

Release versions

Supericons uses separate versions for the product plugin and its MCP runtime:

Component	Current release
Supericons plugin	`2.0.0`
npm MCP runtime	`@supericons/mcp@0.4.22`
Hosted MCP runtime	`0.4.22`

The v2.0 plugin uses the current MCP runtime. There is no npm package named @supericons/mcp@2.0.0.

Quick start

For clients that support remote MCP servers, use the hosted endpoint:

https://mcp.supericons.dev/mcp

For clients that use local MCP commands, use:

{
  "mcpServers": {
    "supericons": {
      "command": "npx",
      "args": ["-y", "@supericons/mcp@latest"]
    }
  }
}

The free tools do not need a Supericons API key.

Plugin files

This repository includes public plugin manifests for Codex, Claude Code, and compatible agent directories:

View the full README on GitHub

Details

Repository: github.com/curlymolelabs/supericons
Categories: Design & Creative, Search & Web Crawling
Package: @supericons/mcp
Transport: STDIO, HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Design & Creative MCP servers

View all

Tapsitemgriffen/tapsiteMCP server for web inspection, design system extraction, and accessibility audits2stars

Source Partssourceparts/parts-mcpElectronic component sourcing, BOM management, and PCB design workflows.2stars

Steam Trends MCPtrendsmcp-ai/steam-trends-mcpSteam concurrent players by game over time, monthly trends and growth. Free key at trendsmcp.ai1stars

Plutocalcdesigner Mcpdanpeig/plutocalcdesigner-mcpPlutocalc Designer is a software suite for water and wastewater treatment plants design1stars

Mcpisco-tec/scorezilla-mcpOfficial Scorezilla MCP: add a global leaderboard to your game by asking Claude Code or Cursor.1stars

AgentSUMOmw-jeong/agentsumoMCP server for LLM-driven SUMO traffic simulation, scenario design, and result analysis.1stars