MCP server

@iconsroom/mcp lets AI agents — Claude Code, Cursor, Windsurf, Claude Desktop, any MCP client — search the library and drop ready-to-paste icons into your code, license attached.

Requires a lifetime license — your IR- token is the API key. Get one here. Without a valid key the tools respond with purchase instructions instead of icons.

Install

Claude Code

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

Cursor / Windsurf / Claude Desktop

Add to your MCP config (.cursor/mcp.json, or the equivalent for your client):

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

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`, `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

Ask your agent: "Add a shopping-cart icon button to the navbar." It calls search_icons("shopping cart"), picks a hit, calls get_icon("tabler", "shopping-cart", format: "react"), 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: licensing.