Summary
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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
4 tools
search_iconsSearch 20,000+ curated SVG icons across 10 libraries by meaning, label, visual description, tags, and synonyms. Use this when the user describes an icon concept such as "database", "user profile", "chill", "security", or "AI model". Returns matching icons with SVG code and pub...5 params
Search 20,000+ curated SVG icons across 10 libraries by meaning, label, visual description, tags, and synonyms. Use this when the user describes an icon concept such as "database", "user profile", "chill", "security", or "AI model". Returns matching icons with SVG code and pub...
Parameters* required
librarystringOptional library key. Supported values include lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons, and mingcute.
limitnumberMaximum number of icons to return. Use 5-10 for browsing and 1-3 for quick agent choices.default: 10
localestringOptional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.one of
zh-Hans · zh-Hant · ja · ko · es · dequerystringIcon concept or search phrase, for example "database", "user profile", "chill", "trash", "upload cloud", "AI model", or "beautiful".
stylestringOptional style preference. Use "any" unless the user asks for outline or solid icons.one of
any · outline · soliddefault: anyrecommend_iconsRecommend a coherent icon set for named UI slots in a product, app, dashboard, or navigation flow. Use this when the user needs several icons that should work together. Returns one recommendation and optional alternatives for each slot.7 params
Recommend a coherent icon set for named UI slots in a product, app, dashboard, or navigation flow. Use this when the user needs several icons that should work together. Returns one recommendation and optional alternatives for each slot.
Parameters* required
librarystringOptional library key when the user wants a consistent icon family. Supported values include lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons, and mingcute.
limit_per_slotnumberNumber of choices to return for each slot. Use 1 for a final pick or 2-3 when the user wants alternatives.default: 3
localestringOptional locale for multilingual slot labels. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.one of
zh-Hans · zh-Hant · ja · ko · es · deresponse_modestringResponse size mode. Use plan for compact icon IDs and reasons, assets to include SVG only for each top recommendation, or full to include SVG and semantic payloads for all returned choices.one of
plan · assets · fulldefault: planslotsarrayList of UI slots to fill, for example ["model", "prompt", "dataset", "evaluation"].
stylestringOptional style preference. Use "outline" for most sidebar and toolbar icon sets unless the user asks otherwise.one of
any · outline · soliddefault: anytaskstringOverall UI task, for example "choose icons for an AI dashboard sidebar" or "select bottom navigation icons for a finance app".
get_iconRetrieve one exact SVG icon when the icon ID and library are already known. Use search_icons first if the user only described a concept. Returns SVG code and public semantic guidance for the exact icon.3 params
Retrieve one exact SVG icon when the icon ID and library are already known. Use search_icons first if the user only described a concept. Returns SVG code and public semantic guidance for the exact icon.
Parameters* required
idstringExact icon ID without the library prefix, for example "database", "user-circle", "brain-circuit", or "arrow-down".
librarystringRequired library key for the exact icon. Supported values include lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons, and mingcute.
stylestringOptional style preference. Use "any" unless the caller needs a specific variant.one of
any · outline · soliddefault: anylist_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 parameter schema in public metadata yet.
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:
.plugin/plugin.json
.codex-plugin/plugin.json
.claude-plugin/plugin.json
.agents/plugins/marketplace.json
The Codex plugin also uses:
.codex-mcp.json
skills/supericons-icon-search/SKILL.md
Manual setup fields
If your client shows a form instead of a config file, enter:
Name: supericons
Transport: stdio
Command: npx
Arguments:
-y
@supericons/mcp@latest
If it has one argument field, enter:
-y @supericons/mcp@latest
Hosted tools
search_icons
: Search by meaning, label, visual description, tags, synonyms, and supported multilingual terms.
recommend_icons
: Recommend a consistent icon set for up to 20 named UI slots.
get_icon
: Retrieve one exact SVG icon when its icon ID and library are known.
preview_icons
: Compare search results or known icon references on a hosted preview page or image.
list_libraries
: List the 11 free icon libraries available through the hosted server.
Example prompts
Use Supericons to find a Lucide database icon. Show the icon id, library, and SVG.
Use Supericons to recommend icons for an AI dashboard sidebar: model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.
Use Supericons to preview the strongest camera scan icons so I can compare them visually.
Pro setup
For Pro access, add the API key as an environment variable:
SUPERICONS_API_KEY=<YOUR_SUPERICONS_API_KEY>
Never paste an API key into a public issue, screenshot, committed config file, or shared chat.
Links
- Website: https://supericons.dev
- MCP setup: https://supericons.dev/mcp/
- npm package: https://www.npmjs.com/package/@supericons/mcp
- Hosted MCP: https://mcp.supericons.dev/mcp
- Server card: https://mcp.supericons.dev/.well-known/mcp/server-card.json
Public repository scope
This repository is the public setup and directory wrapper for Supericons. It contains public manifests, install examples, support information, and brand assets. Private product code, credentials, customer data, and internal operating data are not part of this repository.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Packagesupericons-mcp
TransportSTDIO, HTTP
UpdatedMay 5, 2026
