Use Iconsax with AI — MCP Integration

"Connect your icon library directly to Claude, Cursor, or any MCP-compatible AI tool."

No installation required. Add a single URL to your config and start grabbing icons from your AI assistant.

Quick Start — Free (No account needed)

The free tier gives you instant access to Iconsax free icons with zero setup. Just add one URL to your MCP client config.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "iconsax": {
      "url": "https://iconsax.io/api/mcp"
    }
  }
}

Cursor

Edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "iconsax": {
      "url": "https://iconsax.io/api/mcp"
    }
  }
}

Restart the client. Iconsax tools will appear automatically — no headers, no account, no friction.

Pro Access — +40k Icons

Unlock the full Pro icon library (+40k icons) by adding your API key to the config.

Step 1 — Generate your API key

  1. Go to iconsax.io and log in
  2. Click your avatar → Subscription
  3. Scroll down to the MCP API Key section
  4. Click Generate key
  5. Copy the key — it starts with ix_pro_...

⚠️ Keep your key private. You can rotate it from the same panel at any time.

Step 2 — Add the key to your config

{
  "mcpServers": {
    "iconsax": {
      "url": "https://iconsax.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ix_pro_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

💡 From the Subscription panel, click "Copy config" to get this JSON block pre-filled with your actual key — ready to paste.

Available Tools

Free Tools

ToolDescription
search_iconsSearch icons by keyword. Returns name, category, styles, and SVG
get_iconGet the full SVG for an icon by name and style
get_icon_as_codeReturns the icon ready to paste in React, Vue or HTML
list_categoriesList all icon categories

Pro Tools (requires API key)

ToolDescription
search_pro_iconsSearch the full Pro library (+40k icons)
get_pro_iconGet the full SVG for any Pro icon
get_pro_icon_as_codeReturns any Pro icon ready for React, Vue or HTML

Usage Examples

Here are some prompts you can send directly to your AI assistant once the MCP is configured:

Search for a "home" icon in the bold style

Give me the SVG for the "notification" icon, linear style

Get the "shopping cart" icon as a React component

Find all icons in the "arrow" category

I need a settings icon, outline version as Vue code

Rotating / Revoking your key

  1. Go to Subscription settings in your Iconsax account
  2. Click Rotate key — the previous key is immediately invalidated
  3. Copy the new key and update your config

FAQ

Is it free? Yes, for free icons. Pro access requires an active Pro subscription.

Does the free tier need an account? No. Without any headers or API key, it just works.

Which clients are supported? Claude Desktop and Cursor are officially supported. Any HTTP/JSON-RPC MCP-compatible client will work.

Does it work in CI/CD? Yes. It's a standard HTTPS endpoint.

What happens if my subscription expires? Pro tools will fail; free tools continue working without a key.

Is it the same as my account password? No. It's a separate token used only for MCP connections.

Ready to use icons from your AI?

Add the URL to your client config and start asking for icons by name, style, or category — your AI assistant handles the rest.

Endpoint: https://iconsax.io/api/mcp — JSON-RPC 2.0 over HTTP

neo

Support