Supericons
NPM · @SUPERICONS/MCP · 2 COMPONENTS · SCANNED SEP 24
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security99
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 129 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (SEE LICENSE IN LICENSE) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 22 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability69
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2595 tokens (~185/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management83
- Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Supericons MCP server?
Supericons runs locally as an npm package, launched with npx -y @supericons/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @supericons/mcp
claude mcp add curlymolelabs-supericons -- npx -y @supericons/mcp
{
"mcpServers": {
"curlymolelabs-supericons": {
"command": "npx",
"args": [
"-y",
"@supericons/mcp"
]
}
}
} {
"servers": {
"curlymolelabs-supericons": {
"command": "npx",
"args": [
"-y",
"@supericons/mcp"
]
}
}
} codex mcp add curlymolelabs-supericons -- npx -y @supericons/mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"curlymolelabs-supericons": {
"type": "local",
"command": [
"npx",
"-y",
"@supericons/mcp"
],
"enabled": true
}
}
} openclaw mcp add curlymolelabs-supericons --command npx --arg -y --arg @supericons/mcp
mcp_servers:
curlymolelabs-supericons:
command: "npx"
args: ["-y", "@supericons/mcp"] {
"McpServers": {
"curlymolelabs-supericons": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@supericons/mcp"
]
}
}
} assistant mcp add curlymolelabs-supericons -t stdio -c npx -a -y @supericons/mcp
{
"mcpServers": {
"curlymolelabs-supericons": {
"command": "npx",
"args": [
"-y",
"@supericons/mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 23 Sept 26 −3
- Stability: pass → 0.80 functional
- 22 Sept 26 0
- Stability: 0.97 → pass security
- 21 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → 0.80 functional
- 15 Sept 26 0
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Sept 2026 · Analysed npm/@supericons/mcp@0.4.22
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 129 packages
| Packages resolved | 129 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
animate_icon ~221
Generate both Motion Lab CSS and a self-contained animated SVG for one icon. The CSS output uses a portable {{ICON_SELECTOR}} token you replace with your inline SVG selector. Call get_motion_recipe first if you want to compare presets before exporting. Motion Lab MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | – | Optional CSS color override for icons that inherit currentColor. |
| duration_ms | number | – | Animation duration in milliseconds. |
| id | string | yes | Icon ID, for example heart, scan-virus, or fingerprint-scan. |
| intensity_percent | number | – | Intensity scaling for the preset. |
| library | string | yes | Free icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| preset | string | yes | Motion preset id. |
| trigger | string | – | How the animation should start. |
No output schema declared.
No examples provided.
convert_png_to_svg ~139
Convert a PNG payload to SVG. Converter MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| colorMode | string | – | Tracing color mode. |
| imageBase64 | string | yes | PNG as base64 text or data URL. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| qualityMode | string | – | Tracing quality mode. |
| traceClass | string | – | Tracing profile tuned for the source image. |
| uiMode | string | – | Output bias for logo or icon-style artwork. |
No output schema declared.
No examples provided.
convert_svg_to_png ~111
Convert an SVG string to PNG. Converter MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| background | string | – | Background color: `transparent` or a hex value like `#ffffff`. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| svg | string | yes | Raw SVG string to render. |
| targetWidth | number | – | Output width in pixels. |
No output schema declared.
No examples provided.
export_animated_svg ~200
Generate a self-contained animated SVG using Motion Lab presets. Call get_motion_recipe first if you want to compare presets before exporting. Motion Lab MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | – | Optional CSS color override for icons that inherit currentColor. |
| duration_ms | number | – | Animation duration in milliseconds. |
| id | string | yes | Icon ID, for example heart, scan-virus, or fingerprint-scan. |
| intensity_percent | number | – | Intensity scaling for the preset. |
| library | string | yes | Free icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| preset | string | yes | Motion preset id. |
| trigger | string | – | How the animation should start. |
No output schema declared.
No examples provided.
export_motion_css ~200
Generate Motion Lab CSS for a Supericons icon. The returned CSS uses a portable {{ICON_SELECTOR}} token you replace with your inline SVG selector. Call get_motion_recipe first if you want to compare presets before exporting. Motion Lab MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| duration_ms | number | – | Animation duration in milliseconds. |
| id | string | yes | Icon ID, for example heart, scan-virus, or fingerprint-scan. |
| intensity_percent | number | – | Intensity scaling for the preset. |
| library | string | yes | Free icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| preset | string | yes | Motion preset id. |
| trigger | string | – | How the animation should start. |
No output schema declared.
No examples provided.
get_icon ~143
Retrieve a specific free icon by its ID and library. Returns the full SVG code, metadata, explicit public library labels, browser preview URL, and SI semantic guidance when available. Premium pack icon retrieval is not exposed through MCP yet.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Icon ID (e.g. "heart", "arrow-right", "settings") |
| library | string | yes | Free library key, for example si (Supericons), lucide, tabler, phosphor, iconoir, mingcute, or simpleicons (Simple Icons). |
| style | string | – | Optional style preference. Material Symbols supports outline and solid. Other libraries report their supported styles in list_libraries. |
No output schema declared.
No examples provided.
get_motion_recipe ~153
Return a human-readable Motion Lab recipe for a preset, trigger, and duration. Use this before export tools when you want to compare presets or confirm the motion fit. Motion Lab MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| duration_ms | number | – | Animation duration in milliseconds. |
| intensity_percent | number | – | Intensity scaling for the preset. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| preset | string | yes | Motion preset id, for example pulse, bounce, spin, trace, or typing. |
| trigger | string | – | How the animation should start. |
No output schema declared.
No examples provided.
inspect_converter_input ~107
Inspect a PNG before tracing. Returns structural hints, likely risks, and recommended starting settings for Converter MCP.
| Name | Type | Req | Description |
|---|---|---|---|
| imageBase64 | string | yes | PNG as base64 text or data URL. |
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
| mimeType | string | – | Optional MIME type override. Only image/png is currently supported. |
No output schema declared.
No examples provided.
inspect_converter_options ~73
List the current Converter MCP options, workflow hints, and recommended starting combinations. Converter MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
No output schema declared.
No examples provided.
list_libraries ~29
List the free icon libraries available through Supericons MCP with their names, icon counts, and descriptions.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_motion_presets ~86
List the Motion Lab presets currently available through Supericons MCP, including preset id, label, group, description, and supported triggers. Motion Lab MCP is a Pro workflow tool.
| Name | Type | Req | Description |
|---|---|---|---|
| locale | string | – | Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. |
No output schema declared.
No examples provided.
preview_icons ~283
Refine an icon result set or preview known icon refs. Use search_icons first for normal icon requests. Long icon lists are accepted and safely truncated to 12. Returns a browser preview page, direct PNG image URL, ready-made Markdown image snippet, and, when requested, an MCP image contact sheet.
| Name | Type | Req | Description |
|---|---|---|---|
| icon_refs | array | – | 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. Large… |
| include_image | boolean | – | When true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned. |
| library | – | – | Optional library filter such as si (Supericons), mingcute, lucide, tabler, material, or simpleicons (Simple Icons). |
| limit | number|string | – | Requested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted. |
| locale | – | – | Optional locale for multilingual search terms. Unsupported values are ignored with a warning. |
| query | string | – | Optional search query to preview visually, for example "license plate recognition camera scan car". |
| style | – | – | Optional style preference. Unsupported values are ignored with a warning. |
No output schema declared.
No examples provided.
recommend_icons ~357
Recommend the most suitable icons for up to 20 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 a plain-language reason and a next step instead of a bare protocol error. Returns shortlist choices with preview-ready SVGs, explicit public library labels, browser preview URLs, short reasons, and SI semantic guidance when available. Library key si means Supericons, not Simple Icons.
| Name | Type | Req | Description |
|---|---|---|---|
| include_query_frame | boolean | – | Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses. |
| library | – | – | Optional library filter such as si (Supericons), mingcute, lucide, tabler, material, or simpleicons (Simple Icons). |
| limit_per_slot | number|string | – | How many choices to return per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted. |
| locale | – | – | Optional locale for multilingual slot labels. Unsupported values are ignored with a warning. |
| response_mode | – | – | Response size mode: plan, assets, or full. Unsupported values use plan with a warning. |
| slots | array | – | List of 1 to 20 UI slots to fill, for example ["Home tab", "Create action", "Alerts tab", "Profile tab"]. A single string is accepted as one slot. Larger lists return a structured split instruction. |
| style | – | – | Optional style preference. Unsupported values are ignored with a warning. |
| task | string | – | Overall UI task, for example "replace the 4 bottom navigation icons" or "choose icons for a settings panel". Missing task text returns a structured recovery message. |
No output schema declared.
No examples provided.
search_icons ~342
Use this as the main icon tool. Search 20,000+ curated SVG icons across 11 libraries using synonym expansion. When matches exist, the response includes a paste-ready suggested answer, a direct preview image, and Markdown that can show the image in the final reply. When no supported match exists, it returns an honest structured no-result with a next step and no fabricated icon. Library key si means Supericons, not Simple Icons. Pro API keys unlock workflow tools; premium pack icon search is not exposed through MCP yet.
| Name | Type | Req | Description |
|---|---|---|---|
| include_query_frame | boolean | – | Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses. |
| library | string | – | Filter by free library: si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), or mingcute. |
| library_mode | – | – | Library behavior. Strict stays inside the requested library, prefer puts it first and includes labeled alternatives, and all searches every eligible library. Unsupported values are ignored with a war… |
| limit | number | – | Maximum results from 1 to 50. Numeric strings are accepted. |
| locale | – | – | 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 | yes | Search term, for example "heart", "login", or "download arrow". |
| style | – | – | Optional style preference. Unsupported values are ignored with a warning. |
No output schema declared.
No examples provided.
What is the Supericons MCP server?
Supericons is an MCP server listed in the public MCP registry as io.github.curlymolelabs/supericons. Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons. This page covers its npm package (@supericons/mcp).
Is the Supericons MCP server safe to use?
Supericons scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Supericons MCP server expose?
Supericons exposes 14 tools: search_icons, recommend_icons, get_icon, preview_icons, list_libraries, and 9 more. Their descriptions and schemas cost roughly 2,444 tokens of context every time the server is loaded.
Is the Supericons MCP server still maintained?
Supericons is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.