@keenmate/pure-admin-icons-mcp

MCP server for searching 16,000+ open-source SVG icons from icons.pureadmin.io.

Search across FluentUI, Font Awesome, Heroicons, Lucide, and Tabler icon sets with a single tool. Get platform identifiers for iOS, Android, React, Vue, and Svelte.

Tools

| Tool | Description | |------|-------------| | get_usage_guide | Read first if unsure how to use the server. Returns icon set overview, workflow, and tips. | | search_icons | Search icons by name with filters for set, style, size. Returns names + SVG URLs. | | get_icon_detail | Get full metadata for an icon: all sizes, platform identifiers, color method, phrases. | | get_icon_svg | Fetch raw SVG content from a URL. | | list_icon_sets | List all icon sets with styles, sizes, color methods, and counts. |

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "icons": {
      "command": "npx",
      "args": ["-y", "@keenmate/pure-admin-icons-mcp"]
    }
  }
}

Claude Code

claude mcp add icons -- npx -y @keenmate/pure-admin-icons-mcp

Example Queries

Once connected, ask Claude:

• "Search for calendar icons"
• "Find arrow icons from Heroicons"
• "Show me Font Awesome brand icons for social media"
• "Get the SVG for a pen icon in outline style"
• "What icon sets are available?"
• "Find a 16px solid checkmark icon"

Configuration

| Variable | Default | Description | |----------|---------|-------------| | ICONS_API | https://icons.pureadmin.io | API base URL |

API Endpoints Used

• GET /api/icons/search — Search with filters (q, set, style, size, limit, format)
• GET /api/icons/:id — Icon detail with metadata
• GET /api/icon-sets — List icon sets
• GET /icons/:set/:style/:filename — SVG files
• GET /llms.txt — API documentation for LLMs

Development

npm install
npm run dev     # Watch mode
npm run build   # Build
npm start       # Run locally

License

MIT. Icon SVGs retain their original licenses.

Built by KeenMate.