Build with IconsRoom

A free, no-key REST API over 276,000+ open source icons — plus an MCP server that puts the whole library inside AI coding agents. CORS-open, rate-limited fairly, licenses included in every response.

MCP server — icons for AI agents

Add IconsRoom to Claude Code, Cursor, Windsurf or any MCP client. Agents can search icons and pull ready-to-paste SVG or React components, with license and attribution attached. Requires a lifetime license — your IR-XXXX license token is the key (get lifetime access).

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

# Cursor / Windsurf / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "iconsroom": {
      "command": "npx", "args": ["-y", "@iconsroom/mcp"],
      "env": { "ICONSROOM_API_KEY": "IR-XXXXXXXXXXXXXXXX" }
    }
  }
}

Tools: search_icons, get_icon (svg / react / url / datauri, optional recolor), list_packs, get_pack.

REST API v1

No authentication required. Please cache responses and keep within the fair-use rate limits (60 searches/min, 120 icon fetches/min per IP).

GET/api/v1/search?q={query}&pack={key}&limit={n}

Search icons by keyword. Optional pack filter. Max 50 results.

curl "https://iconsroom.com/api/v1/search?q=arrow&limit=5"

GET/api/v1/icon/{pack}/{name}?format=json|svg&color=%23hex

Fetch one icon — JSON with metadata + markup, or raw SVG. Optional recolor for monochrome icons.

curl "https://iconsroom.com/api/v1/icon/heroicons/academic-cap?format=svg&color=%230f172a"

GET/api/v1/packs

All 220 icon packs with counts, categories and licenses.

curl "https://iconsroom.com/api/v1/packs"

React package

@iconsroom/react gives you all 276,000 icons in React — a runtime <Icon> component, or a CLI to vendor any icon as a local component you own. Free.

npm install @iconsroom/react react

import { Icon } from '@iconsroom/react';
<Icon pack="heroicons" name="academic-cap" size={24} color="#0f172a" />

# …or vendor icons as local components (no runtime dependency):
npx @iconsroom/react add tabler/home tabler/settings --ts

All the ways to use IconsRoom

MCP, this API and the React package are the developer surfaces. There are also plugins for Figma, VS Code, Chrome and Raycast — see them all on the integrations page.

Licensing

Every API and MCP response includes the icon pack's license. Most packs are MIT, Apache 2.0 or CC BY; a small number are CC BY-NC (non-commercial only). Details on the licensing page.