Supericons

io.github.curlymolelabsPublished by GitHub account curlymolelabsv0.4.22Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableDeveloper ToolsMedia & Design

Overview

AI-generated overview

Supericons lets an assistant search 20,000+ free SVG icons across 11 libraries by meaning, preview them, and return ready-to-use SVG code.

What you can do
  • Search icons by meaning, label, visual description, tags, synonyms and multilingual terms, with preview images and Markdown.
  • Recommend a coherent icon set for up to 20 named UI slots, asking for clarification when context is thin.
  • Fetch one exact SVG icon by its reference, with library labels and preview URL.
  • Preview or compare known icon references on a hosted preview page or PNG image.
  • List the free icon libraries available through the hosted server.
When to use it
Useful when building or editing a UI and you want the assistant to pick fitting icons by meaning rather than filename, or to assemble a consistent icon set for a screen. Also handy for comparing candidate icons visually before committing to one.
Requirements
Either the hosted remote endpoint or a local process run with npx from the npm package. No API key is needed for the free tools; Pro access uses the SUPERICONS_API_KEY environment variable. Network access is needed for search and hosted previews.
Before you install
Pro access requires an API key in SUPERICONS_API_KEY, which should not be pasted into public issues, screenshots, committed config files or shared chats. Search queries and icon references are sent to the hosted service, and preview images are loaded from its servers.

Installation

In SourceWeft

  1. Open Supericons in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.curlymolelabs%2Fsupericons/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "supericons": {
      "type": "http",
      "url": "https://mcp.supericons.dev/mcp"
    }
  }
}

README

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:

ComponentCurrent release
Supericons plugin2.0.0
npm MCP runtime@supericons/[email protected]
Hosted MCP runtime0.4.22

The v2.0 plugin uses the current MCP runtime. There is no npm package named @supericons/[email protected].

Quick start

For clients that support remote MCP servers, use the hosted endpoint:

text
https://mcp.supericons.dev/mcp

For clients that use local MCP commands, use:

json
{  "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:

text
.plugin/plugin.json.codex-plugin/plugin.json.claude-plugin/plugin.json.agents/plugins/marketplace.json

The Codex plugin also uses:

text
.codex-mcp.jsonskills/supericons-icon-search/SKILL.md

Manual setup fields

If your client shows a form instead of a config file, enter:

text
Name: supericonsTransport: stdioCommand: npxArguments:-y@supericons/mcp@latest

If it has one argument field, enter:

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

text
Use Supericons to find a Lucide database icon. Show the icon id, library, and SVG.
text
Use Supericons to recommend icons for an AI dashboard sidebar: model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.
text
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:

text
SUPERICONS_API_KEY=<YOUR_SUPERICONS_API_KEY>

Never paste an API key into a public issue, screenshot, committed config file, or shared chat.

Links

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.

Source: README.md at commit 8875d68

Tools

5

search_icons

Search Icons

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.

Parameterslimitqueryrequiredstylelocalelibrarylibrary_modeinclude_query_frame

recommend_icons

Recommend Icons

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.

Parameterstaskslotsstylelocalelibraryresponse_modelimit_per_slotinclude_query_frame

get_icon

Get Icon

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.

Parametersidrequiredstylelibraryrequired

preview_icons

Preview Icons

Refine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Icon lists up to 100 refs 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.

Parameterslimitquerystylelocalelibraryicon_refsinclude_image

list_libraries

List Libraries

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.

Takes no parameters.

Version history

1
  1. v0.4.22LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts