MCP.Market

Supericons MCP server

online · 100% uptime
by curlymolelabs·io.github.curlymolelabs/supericons·v0.4.22·1 stars
No reviews yet

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

A88/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

1 stars39 downloads/wk

Reviews

Write one

Nobody has reviewed Supericons yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Supericons tools (5)

write = sends, deletes, buys or posts
  • get_iconFree

    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 semantic guidance for the exact icon.

  • list_librariesFree

    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.

  • preview_iconsFree

    Refine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Long icon lists are accepted and safely truncated to 12. Returns ready-to-use Markdown, a hosted preview fallback, a direct PNG image URL, and, when requested, an MCP image contact sheet.

  • recommend_iconsFree

    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 a plain-language reason and a next step instead of a bare protocol error. Returns one recommendation and optional alternatives for each resolved slot, with explicit public library labels and visual preview URLs where available. Library key si means Supericons, not Simple Icons.

  • search_iconsFree

    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 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. If you choose a library yourself, use prefer. Use strict only when the user explicitly requires that library. Library key si means Supericons, not Simple Icons.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan51 source files scanned25/25
  • Live reliabilityremote reachable in 455ms20/20
  • Tool poisoning5 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 51 days ago12/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Supericons compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 80% of 3,470 Web search servers
Tools
5
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote Web search server answers 100%
Response time
117 ms
faster than 85% of 2,238 Web search servers
GitHub stars
1
more than 55% of 1,786 Web search servers
Downloads a week
39
more than 25% of 827 Web search servers with a package

What its tools let an agent do: 5 read

Install Supericons in Claude Code, Cursor or VS Code

claude mcp add --transport http supericons https://mcp.supericons.dev/mcp
Add to Cursor

What the publisher says

From the Supericons repository's README, as published. We do not edit it. Read it on GitHub

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:

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.

Nothing above is checked by us. What we check is on the safety report.

Supericons: common questions

Is Supericons MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Supericons safety report
How do I install Supericons?
It runs remotely at mcp.supericons.dev. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Supericons need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Supericons maintained?
The last commit was 92 days ago (2026-08-04). The latest release is v0.4.22.
Is Supericons up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Supericons?
Servers from other publishers that do the same job: Keyline Icons MCP server, Vadivam Icons MCP server and Documentation MCP server. Compare all Supericons alternatives.
How does Supericons compare with other Web search MCP servers?
safety score 88/100 (higher than 80% of 3,470 Web search servers); tools 5 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Supericons

Same job from other publishers: the closest match first, then the best rated.

All Supericons alternatives →
  • Keyline Icons
    Search Keyline Icons by name and get any icon's SVG source or React import. No key, no network.
    A
  • Vadivam Icons
    Search 24px outline icons by name, tag, or category and get SVG or framework code.
    A
  • Documentation
    Local-first document management and semantic search for AI coding agents
    A
  • Repomix
    Pack local or remote codebases into AI-friendly files that LLMs and coding agents can read or search
    A
  • Arxiv
    Search arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.
    A