@iconsroom/mcp

@iconsroom/mcp

MCP server for IconsRoom — search 276,000+ open source icons from 220 packs and drop them straight into your code from any MCP client.

Requirements

An IconsRoom lifetime license (one-time payment — iconsroom.com/pricing). Your license token (IR-XXXX…, from the purchase confirmation) is your API key.

Install

Claude Code

claude mcp add iconsroom --env ICONSROOM_API_KEY=IR-XXXXXXXXXXXXXXXX -- npx -y @iconsroom/mcp

Cursor (.cursor/mcp.json) / Windsurf / Claude Desktop

{
  "mcpServers": {
    "iconsroom": {
      "command": "npx",
      "args": ["-y", "@iconsroom/mcp"],
      "env": { "ICONSROOM_API_KEY": "IR-XXXXXXXXXXXXXXXX" }
    }
  }
}

Without a valid key the tools respond with purchase instructions instead of icons.

Tools

Tool	What it does
search_icons	Keyword search across all packs (optionally scoped to one pack)
get_icon	Fetch an icon as svg, react (JSX component), url, or datauri — with optional recoloring for monochrome icons
list_packs	Browse the 220 packs with icon counts, categories and licenses
get_pack	Details + sample icons for one pack

Example

"Add a shopping-cart icon button to the navbar"

The agent calls search_icons("shopping cart"), picks a hit, calls get_icon("tabler", "shopping-cart", format: "react", color: "#0f172a"), and pastes a ready JSX component — license and source URL included in the header comment.

Licensing

Every result carries its pack's license (MIT, Apache 2.0, CC BY…). A small number of packs are CC BY-NC (non-commercial) — the license field tells you. Full details: iconsroom.com/licensing.

Development

npm install
npm test        # protocol-level test over stdio (12 checks)

MIT © IconsRoom