Log inSubmit server
Supericons logo

Supericons

Searches 20,000+ free SVG icons by meaning, retrieves SVGs, recommends sets, and provides visual previews.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Supericons

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "supericons": {
      "command": "npx",
      "args": [
        "-y",
        "@supericons/mcp@latest"
      ],
      "env": {
        "SUPERICONS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 14 tools correctly (Today).

Overview

Supericons MCP server provides semantic SVG icon search for AI coding agents, covering more than 20,000 free icons across 11 libraries. Agents can search by meaning, labels, descriptions, tags, synonyms, and supported multilingual terms, then retrieve SVG code or compare results visually. Use it when an agent needs to identify individual icons or assemble a consistent icon set for named UI slots. It runs through a hosted MCP endpoint or a local npm-based stdio configuration, with free tools requiring no API key.

Use cases

  • Search for icons by meaning or visual description
  • Retrieve SVG code for a known icon
  • Recommend a consistent icon set for UI slots
  • Compare candidate icons in a visual preview
  • List the available free icon libraries

Key features

  • Semantic search across 20,000+ free icons
  • Support for 11 icon libraries
  • Multilingual search terms
  • SVG retrieval by icon ID and library
  • Icon set recommendations for up to 20 UI slots
  • Hosted visual previews

Tools14

What Supericons lets your agent do. Expand a tool for its parameters.

Verified live~4.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 53d

What it can do

From the 14 tools this server returned when we ran it.

Handles credentials · 3Makes network requests · 2Read-only tools · 14
Network at startup4 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age167 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @supericons/mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads4.5kPackage downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed14Callable tools this server registers over MCP.

How Supericons works

What Supericons MCP server does

The Supericons MCP server connects AI coding agents to a searchable collection of more than 20,000 free SVG icons from 11 libraries. Its search is semantic rather than limited to exact filenames, so an agent can look for an icon using a meaning, label, visual description, tag, synonym, or supported multilingual term.

The server supports both individual icon lookup and broader UI planning. An agent can retrieve SVG code for a known icon, ask for recommendations across up to 20 named UI slots, or generate a visual comparison of candidate icons. This makes it suitable for interface work where the agent needs to select an icon family, inspect alternatives, or return implementation-ready SVG data.

How it works

Supericons MCP server can be reached through the hosted streamable MCP endpoint at https://mcp.supericons.dev/mcp, or launched locally through the npm package @supericons/mcp. Hosted access is configured as a remote MCP server, while local access uses the npx command and standard input/output transport.

The free tools do not require an API key. Pro access uses the SUPERICONS_API_KEY environment variable. The repository separates the product plugin version from the MCP runtime version; the documented plugin release is 2.0.0, while the npm and hosted runtimes are listed as 0.4.22.

Setup and configuration

For a local client configuration, register a server named supericons with npx as the command and these arguments:

  • -y
  • @supericons/mcp@latest

Clients that accept a single argument field can use -y @supericons/mcp@latest. Clients with remote MCP support can use the hosted endpoint instead. The repository includes public plugin manifests for Codex and Claude Code, along with an agent marketplace manifest and Codex-specific MCP and skill files.

For paid functionality, set SUPERICONS_API_KEY in the server environment. Do not place the key in committed configuration, public issues, screenshots, or shared chats.

Tools and capabilities

The Supericons MCP server exposes these documented tools:

  • search_icons searches icon content by meaning, metadata, visual description, and supported multilingual terms.
  • recommend_icons proposes a consistent icon set for as many as 20 named interface slots.
  • get_icon returns one exact SVG when both its icon ID and library are known.
  • preview_icons creates a hosted preview page or image for comparing search results or known icon references.
  • list_libraries returns the 11 free icon libraries available through the hosted server.

Search results can be used to request an icon ID, library, and SVG. Recommendation prompts can specify a UI context and a preferred library or style, such as Lucide outline icons.

Limitations and notes

Exact icon retrieval requires the icon ID and library. Recommendations are limited to 20 named UI slots per request.

The repository is a public setup and directory wrapper rather than the private product implementation. It contains manifests, installation examples, support information, and brand assets; private product code, credentials, customer data, and internal operating data are excluded. The documented runtime package is @supericons/mcp@0.4.22; the README specifically notes that @supericons/mcp@2.0.0 is not an npm package.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Supericons

Supericons is an MCP server that connects AI coding agents to more than 20,000 free SVG icons across 11 libraries. Its main tools search icons semantically, recommend consistent sets for UI slots, retrieve exact SVGs, create visual previews, and list available libraries.

Install it by configuring your MCP client to run `npx -y @supericons/mcp@latest` over stdio. If your client supports remote MCP servers, use `https://mcp.supericons.dev/mcp` instead.

No, the free tools do not require an API key. Pro access uses the `SUPERICONS_API_KEY` environment variable, which should not be committed to configuration files or shared publicly.

You can search by meaning, label, visual description, tags, synonyms, and supported multilingual terms. The server can return search results for comparison or help an agent select an icon for a named interface role.

Yes, `recommend_icons` can recommend a consistent set for up to 20 named UI slots. Prompts can describe the interface context and preferences such as a specific library or Lucide outline icons.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSupericons AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/supericons?style=directory)](https://allmcps.com/mcp/supericons)
HTML Embed
<a href="https://allmcps.com/mcp/supericons"><img src="https://allmcps.com/api/badge/supericons?style=directory" alt="Supericons on AllMCPs" /></a>