Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

Supericons

NPM · @SUPERICONS/MCP · 2 COMPONENTS · SCANNED AUG 3

Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.

+35 this week 61 Trust /100
Trust breakdown (6 categories)

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 →

Supply Chain Security90
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (128 of 129), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (128 of 129), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency32
Schema Quality & AI Usability65
  • 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 Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
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
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @supericons/mcp

# add to Claude Code
claude mcp add curlymolelabs-supericons -- npx -y @supericons/mcp
# add to Codex CLI
codex mcp add curlymolelabs-supericons -- npx -y @supericons/mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "curlymolelabs-supericons": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@supericons/mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add curlymolelabs-supericons --command npx --arg -y --arg @supericons/mcp
# ~/.hermes/config.yaml
mcp_servers:
  curlymolelabs-supericons:
    command: "npx"
    args: ["-y", "@supericons/mcp"]
// mcp.json
{
  "mcpServers": {
    "curlymolelabs-supericons": {
      "command": "npx",
      "args": [
        "-y",
        "@supericons/mcp"
      ]
    }
  }
}
Changelog

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.

  • 2 Aug 26 +28
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • License: unverified → fail functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Licence: SEE LICENSE IN LICENSE functional
  • 31 Jul 26 +27
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −69
    • Install scripts: pass → unverified security
    • Provenance: fail → unverified security
    • Known CVEs: partial → unverified security
    • Malware scan: pass → unverified security
    • Tool coverage: 100 → unverified functional
    • Dependency health: partial → unverified functional
    • Maintenance: pass → unverified functional
    • License: fail → unverified functional
    • Licence: SEE LICENSE IN LICENSE functional
  • 28 Jul 26 +49
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • License: unverified → fail functional
    • Tool coverage: unverified → 100 functional
    • Maintenance: unverified → pass functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: excellent functional
    • First check of Schema quality: fail functional
    • First check of Tool coverage: 100 functional
    • Licence: SEE LICENSE IN LICENSE functional
  • 27 Jul 26 26

    First indexed and scored.

Diagnostics

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 3 Aug 2026 · Analysed npm/@supericons/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 128 packages

128 packages in the resolved dependency tree · 110 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 14 exposed · ~2,444 tokens

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.

Tool Tokens
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.

NameTypeReqDescription
colorstringOptional CSS color override for icons that inherit currentColor.
duration_msnumberAnimation duration in milliseconds.
idstringyesIcon ID, for example heart, scan-virus, or fingerprint-scan.
intensity_percentnumberIntensity scaling for the preset.
librarystringyesFree icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
presetstringyesMotion preset id.
triggerstringHow 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.

NameTypeReqDescription
colorModestringTracing color mode.
imageBase64stringyesPNG as base64 text or data URL.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
qualityModestringTracing quality mode.
traceClassstringTracing profile tuned for the source image.
uiModestringOutput 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.

NameTypeReqDescription
backgroundstringBackground color: `transparent` or a hex value like `#ffffff`.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
svgstringyesRaw SVG string to render.
targetWidthnumberOutput 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.

NameTypeReqDescription
colorstringOptional CSS color override for icons that inherit currentColor.
duration_msnumberAnimation duration in milliseconds.
idstringyesIcon ID, for example heart, scan-virus, or fingerprint-scan.
intensity_percentnumberIntensity scaling for the preset.
librarystringyesFree icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
presetstringyesMotion preset id.
triggerstringHow 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.

NameTypeReqDescription
duration_msnumberAnimation duration in milliseconds.
idstringyesIcon ID, for example heart, scan-virus, or fingerprint-scan.
intensity_percentnumberIntensity scaling for the preset.
librarystringyesFree icon library key, for example lucide, tabler, phosphor, iconoir, or mingcute.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
presetstringyesMotion preset id.
triggerstringHow 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.

NameTypeReqDescription
idstringyesIcon ID (e.g. "heart", "arrow-right", "settings")
librarystringyesFree library key, for example si (Supericons), lucide, tabler, phosphor, iconoir, mingcute, or simpleicons (Simple Icons).
stylestringOptional 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.

NameTypeReqDescription
duration_msnumberAnimation duration in milliseconds.
intensity_percentnumberIntensity scaling for the preset.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
presetstringyesMotion preset id, for example pulse, bounce, spin, trace, or typing.
triggerstringHow 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.

NameTypeReqDescription
imageBase64stringyesPNG as base64 text or data URL.
localestringOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
mimeTypestringOptional 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.

NameTypeReqDescription
localestringOptional 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.

NameTypeReqDescription
localestringOptional 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.

NameTypeReqDescription
icon_refsarrayOptional 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_imagebooleanWhen true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned.
libraryOptional library filter such as si (Supericons), mingcute, lucide, tabler, material, or simpleicons (Simple Icons).
limitnumber|stringRequested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted.
localeOptional locale for multilingual search terms. Unsupported values are ignored with a warning.
querystringOptional search query to preview visually, for example "license plate recognition camera scan car".
styleOptional 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.

NameTypeReqDescription
include_query_framebooleanOptional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.
libraryOptional library filter such as si (Supericons), mingcute, lucide, tabler, material, or simpleicons (Simple Icons).
limit_per_slotnumber|stringHow many choices to return per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted.
localeOptional locale for multilingual slot labels. Unsupported values are ignored with a warning.
response_modeResponse size mode: plan, assets, or full. Unsupported values use plan with a warning.
slotsarrayList 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.
styleOptional style preference. Unsupported values are ignored with a warning.
taskstringOverall 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.

NameTypeReqDescription
include_query_framebooleanOptional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.
librarystringFilter 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_modeLibrary 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…
limitnumberMaximum results from 1 to 50. Numeric strings are accepted.
localeOptional 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.
querystringyesSearch term, for example "heart", "login", or "download arrow".
styleOptional style preference. Unsupported values are ignored with a warning.

No output schema declared.

No examples provided.