English Français العربية

Supericons

Official registry Developer tools

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http supericons 'https://mcp.supericons.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "supericons": {
            "type": "http",
            "url": "https://mcp.supericons.dev/mcp"
        }
    }
}
NPM package @supericons/mcp
Claude Code 
claude mcp add supericons -- npx -y @supericons/mcp@0.4.22
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "supericons": {
            "command": "npx",
            "args": [
                "-y",
                "@supericons/mcp@0.4.22"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Supericons v2.0
  2. Release versions
  3. Quick start
  4. Plugin files
  5. Manual setup fields
  6. Hosted tools
  7. Example prompts
  8. Pro setup
  9. Links
  10. Public repository scope

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/mcp@0.4.22
Hosted MCP runtime0.4.22

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.

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.

Frequently asked questions

What is Supericons?

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

How do I install Supericons?

It runs as a remote server. In Claude Code: claude mcp add --transport http supericons 'https://mcp.supericons.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Supericons need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Supericons open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Supericons?

It is published by curlymolelabs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.