# Supericons (npm · @supericons/mcp)

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

- Trust score: 61/100 (medium)
- Change this week: +35
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.supericons.dev`: 70/100, [markdown](https://verifymcp.io/servers/curlymolelabs-supericons/mcp.md), [page](https://verifymcp.io/servers/curlymolelabs-supericons/mcp)
- npm · `@supericons/mcp`: 61/100 (this document), [markdown](https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2.md), [page](https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2)

## Channel facts

- Registry: `npm`
- Package: `@supericons/mcp`
- Version: `0.4.22`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 90/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (128 of 129), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (128 of 129), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: the license (SEE LICENSE IN LICENSE) isn't a recognized OSI-approved license.
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**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

### Claude

```bash
claude mcp add curlymolelabs-supericons -- npx -y @supericons/mcp
```

### Codex

```bash
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
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add curlymolelabs-supericons --command npx --arg -y --arg @supericons/mcp
```

### Hermes

```yaml
mcp_servers:
  curlymolelabs-supericons:
    command: "npx"
    args: ["-y", "@supericons/mcp"]
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 61, +28)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional regression] License: unverified → fail
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: SEE LICENSE IN LICENSE

### 2026-07-31 (score 33, +27)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, −69)

- [security regression] Install scripts: pass → unverified
- [security regression] Provenance: fail → unverified
- [security regression] Known CVEs: partial → unverified
- [security regression] Malware scan: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Dependency health: partial → unverified
- [functional regression] Maintenance: pass → unverified
- [functional regression] License: fail → unverified
- [functional] Licence: SEE LICENSE IN LICENSE

### 2026-07-28 (score 75, +49)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [functional regression] License: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] 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

### 2026-07-27 (score 26)

First indexed and scored.

## MCP tools (14)

### `search_icons` (~342 tokens)

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.

Input parameters:

- `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, required): Search term, for example "heart", "login", or "download arrow".
- `style`: Optional style preference. Unsupported values are ignored with a warning.

### `recommend_icons` (~357 tokens)

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.

Input parameters:

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

### `get_icon` (~143 tokens)

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.

Input parameters:

- `id` (string, required): Icon ID (e.g. "heart", "arrow-right", "settings")
- `library` (string, required): 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.

### `preview_icons` (~283 tokens)

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.

Input parameters:

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

### `list_libraries` (~29 tokens)

List the free icon libraries available through Supericons MCP with their names, icon counts, and descriptions.

### `list_motion_presets` (~86 tokens)

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.

Input parameters:

- `locale` (string): Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.

### `get_motion_recipe` (~153 tokens)

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.

Input parameters:

- `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, required): Motion preset id, for example pulse, bounce, spin, trace, or typing.
- `trigger` (string): How the animation should start.

### `export_motion_css` (~200 tokens)

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.

Input parameters:

- `duration_ms` (number): Animation duration in milliseconds.
- `id` (string, required): Icon ID, for example heart, scan-virus, or fingerprint-scan.
- `intensity_percent` (number): Intensity scaling for the preset.
- `library` (string, required): 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, required): Motion preset id.
- `trigger` (string): How the animation should start.

### `export_animated_svg` (~200 tokens)

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.

Input parameters:

- `color` (string): Optional CSS color override for icons that inherit currentColor.
- `duration_ms` (number): Animation duration in milliseconds.
- `id` (string, required): Icon ID, for example heart, scan-virus, or fingerprint-scan.
- `intensity_percent` (number): Intensity scaling for the preset.
- `library` (string, required): 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, required): Motion preset id.
- `trigger` (string): How the animation should start.

### `animate_icon` (~221 tokens)

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.

Input parameters:

- `color` (string): Optional CSS color override for icons that inherit currentColor.
- `duration_ms` (number): Animation duration in milliseconds.
- `id` (string, required): Icon ID, for example heart, scan-virus, or fingerprint-scan.
- `intensity_percent` (number): Intensity scaling for the preset.
- `library` (string, required): 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, required): Motion preset id.
- `trigger` (string): How the animation should start.

### `inspect_converter_options` (~73 tokens)

List the current Converter MCP options, workflow hints, and recommended starting combinations. Converter MCP is a Pro workflow tool.

Input parameters:

- `locale` (string): Optional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.

### `inspect_converter_input` (~107 tokens)

Inspect a PNG before tracing. Returns structural hints, likely risks, and recommended starting settings for Converter MCP.

Input parameters:

- `imageBase64` (string, required): 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.

### `convert_svg_to_png` (~111 tokens)

Convert an SVG string to PNG. Converter MCP is a Pro workflow tool.

Input parameters:

- `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, required): Raw SVG string to render.
- `targetWidth` (number): Output width in pixels.

### `convert_png_to_svg` (~139 tokens)

Convert a PNG payload to SVG. Converter MCP is a Pro workflow tool.

Input parameters:

- `colorMode` (string): Tracing color mode.
- `imageBase64` (string, required): 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.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2#diagnostics

## Score history

- 2026-08-03: 61
- 2026-08-02: 61
- 2026-08-01: 33
- 2026-07-31: 33
- 2026-07-30: 6
- 2026-07-28: 75
- 2026-07-27: 26

## Links

- npm package: https://www.npmjs.com/package/@supericons/mcp
- Socket report: https://socket.dev/npm/package/@supericons/mcp
- Repository: https://github.com/curlymolelabs/supericons
- Changelog RSS feed: https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2/changelog.json
- HTML version of this page: https://verifymcp.io/servers/curlymolelabs-supericons/supericons-mcp-2