# Supericons

Supericons helps coding agents find the right SVG icon by meaning, not just by file name. Search 20,000+ free icons, filter by library, retrieve SVG code, and recommend icon sets for app navigation, …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add curly-mole-labs/supericons

# Browse available tools
npx -y smithery tool list curly-mole-labs/supericons

# Get full schema for a tool
npx -y smithery tool get curly-mole-labs/supericons search_icons

# Call a tool
npx -y smithery tool call curly-mole-labs/supericons search_icons '{}'
```

## Direct MCP Connection

Endpoint: `https://supericons.run.tools`

## Tools (4)

- `search_icons` — Search 20,000+ free icons across 10 libraries by meaning, label, visual description, tags, and synonyms. Use this when …
- `recommend_icons` — Recommend a coherent icon set for named UI slots in a product, app, dashboard, or navigation flow. Use this when the us…
- `get_icon` — Retrieve one exact SVG icon when the icon ID and library are already known. Use search_icons first if the user only des…
- `list_libraries` — List the free icon libraries available through the hosted Supericons MCP server. Use this before filtering by library o…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get curly-mole-labs/supericons <tool-name>
```
