A Model Context Protocol server that gives AI agents direct access to the totakit icon library. Search by meaning, retrieve by name, browse by category — every response includes SVG ready to embed.

All icon data is bundled at build time. The server makes zero network calls and works fully offline.

Quick Start

npx @totakit/icons-mcp-server

Configuration

Claude Desktop

{
  "mcpServers": {
    "totakit-icons": {
      "command": "npx",
      "args": ["@totakit/icons-mcp-server"]
    }
  }
}

Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "totakit-icons": {
      "command": "npx",
      "args": ["@totakit/icons-mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "totakit-icons": {
      "command": "npx",
      "args": ["@totakit/icons-mcp-server"]
    }
  }
}

Tools

icons_search

Search icons by name, concept, or description.

query:  "arrow"           # Search term
style:  "outline"         # outline | solid | duotone | thin | bold | micro
limit:  5                 # 1–50

Returns matching icons with SVG data, category, tags, CDN URL, and relevance score.

icons_get

Retrieve a specific icon by exact name.

name:   "arrow-right"     # kebab-case icon name
style:  "outline"         # outline | solid | duotone | thin | bold | micro
size:   24                # 8–256 pixels

Returns the icon with SVG at the requested size, all metadata, and available styles.

icons_categories

List all icon categories with counts and example icons.

Returns category names, labels, icon counts, and example icon names.

Styles

Each icon is available in 6 styles:

| Style | Description | |-------|-------------| | Outline | 1.5px stroke — default UI, navigation | | Solid | Filled — buttons, active states | | Duotone | Two-tone — dashboards, illustrations | | Thin | 1.0px stroke — elegant, large sizes | | Bold | 2.0px stroke — small sizes, emphasis | | Micro | Simplified — 12–16px, favicons |

Related

| Repository | Description | |------------|-------------| | @totakit/icons | React components and SVG files | | icons.totakit.com | Browse, search, and preview icons | | @totakit/cli | Command-line interface | | @totakit/sdk | JavaScript/TypeScript SDK |

License

MIT © totakit