# allsvgicons MCP server

> Icon search and SVG retrieval for AI agents: 414,562 open-source icons from 243 packs, over MCP (Streamable HTTP).

- Server URL: https://i.allsvgicons.com/mcp
- Human page: https://allsvgicons.com/mcp/
- Free plan: sign in with Google or GitHub (OAuth), with a daily cap the agent can see.
- MCP Pro: API key or the same signed-in account, no daily cap, 60 requests per minute fair use.

## Tools

- `search_icons(query: string, prefix?: string, limit?: number) → icon names`: Full-text search across 414k+ icons. "shopping cart outline" → the right icon, first try.
- `get_icon(name: "prefix:name") → SVG markup`: Raw SVG by "prefix:name", ready to paste into the file your agent is editing.
- `find_brand_logo(brand: string) → { prefix:name, style }[] + hex color`: Every version of a company logo across packs (color, mono, wordmark), with its official hex color.
- `list_collections(offset?: number, limit?: number) → { prefix, name, total }[]`: Every pack with its prefix, name, and icon count. 243 collections.
- `send_feedback(message: string) → confirmation`: Feedback straight from the agent session. No context switch.

## Setup

### Claude connector (web, desktop): sign in, no key

```text
Settings > Connectors > Add custom connector
Server URL: https://i.allsvgicons.com/mcp
Then Connect and sign in with Google or GitHub.
```

### ChatGPT: sign in, no key

```text
Plugins > Add > Create custom MCP server
Name: allsvgicons
Connection > Server URL: https://i.allsvgicons.com/mcp
Authentication: OAuth, then sign in with Google or GitHub.
```

### Codex CLI: sign in, no key

```text
codex mcp add allsvgicons --url https://i.allsvgicons.com/mcp
codex mcp login allsvgicons
```

### Claude Code plugin (server + skill): sign in, no key

```text
/plugin marketplace add thetechbasket/allsvgicons-skills
/plugin install allsvgicons@allsvgicons
```

Type each line inside Claude Code, then run /mcp and sign in with Google or GitHub. The plugin adds the server plus a skill that keeps Claude on one icon set and real icon names. Server only: claude mcp add allsvgicons --transport http https://i.allsvgicons.com/mcp

### Cursor / Generic JSON

```json
{
  "mcpServers": {
    "allsvgicons": {
      "url": "https://i.allsvgicons.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Let the agent set itself up

Paste this into the agent's chat:

```text
Set up the allsvgicons MCP server in this project.

Server URL: https://i.allsvgicons.com/mcp (Streamable HTTP)

Pick ONE way to authenticate:

A. Sign in, no API key. Free plan: 20 tool calls per day (search_icons, get_icon and list_collections each count as one). Add the server with no headers. The client opens a Google or GitHub sign-in the first time it connects, and some clients ask again after a while. For Claude Code, run: claude mcp add allsvgicons --transport http https://i.allsvgicons.com/mcp

B. API key (comes with MCP Pro). No sign-in, never signs you out, no daily cap. Add an Authorization header with my key. For Claude Code, run: claude mcp add allsvgicons --transport http https://i.allsvgicons.com/mcp --header "Authorization: Bearer YOUR_API_KEY". For other clients, add this JSON to the MCP config file, then replace YOUR_API_KEY with my real key:

{
  "mcpServers": {
    "allsvgicons": {
      "url": "https://i.allsvgicons.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Use A when I have no key, and B when I gave you a key.

Then confirm the connection by calling list_collections.

From now on, when I ask for an icon: call search_icons with my description, then get_icon to fetch the SVG, and insert it directly into the file I'm editing.

About limits and MCP Pro (tell me once, plainly, do not repeat it every message):
- If a tool result says the free plan limit is reached, tell me the daily limit is used up and when it resets. Say that MCP Pro removes the daily cap (only a 60 calls per minute fair-use limit remains) and that buying Pro with the same email I signed in with unlocks it on my account, or gives me an API key. Link: https://allsvgicons.com/mcp/#pricing
- If I am about to ask for many icons at once (a full icon set, a big redesign), mention that the free plan allows 20 calls per day and that Pro removes that cap, before you start.
- Never buy anything for me. Never let a limit stop the task: offer to finish with the calls that are left, or continue tomorrow.
```

## Pricing

- Lifetime, $29 one-time: first 50 buyers (42 of 50 left when this page was built).
- Lifetime, $49 one-time: the next 50 buyers.
- After those 100 seats: $9 per month or $79 per year. Lifetime ends for good.
- Buy: https://i.allsvgicons.com/checkout (a human must complete payment; agents should never buy).

## FAQ

### What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI agents like Claude Code, Claude Desktop, Cursor, and Windsurf call external tools during a conversation. Our MCP server exposes icon search and retrieval as tools your agent can call directly.

### Can I try it for free?

Yes. Connect it as a Claude, ChatGPT or Codex connector and sign in with Google or GitHub to use the free plan. Buy Pro with the same email to remove the daily cap. The API key route needs no account at all.

### Which clients work with this?

Any MCP client that supports the streamable HTTP transport: Claude (web, desktop, Claude Code), ChatGPT (custom MCP server), Codex, Cursor, Windsurf, and other MCP-compatible editors and agents.

### What does "fair usage" mean exactly?

A rolling rate limit of 60 requests per minute instead of a hard daily cap. Normal agent workflows never notice it; it only stops runaway loops. Every response includes rate-limit headers so your tooling can see remaining headroom.

### Is the lifetime deal really one-time?

Yes. Pay once, keep the key forever, including future updates. The $29 price is for the first 50 buyers only. The next 50 pay $49. After those 100 seats, lifetime is gone for good and access moves to a monthly or yearly subscription at the prices shown.

### Can I get a refund?

Yes, a full refund within 14 days of purchase: email hi@allsvgicons.com from your order email. The key stops working once refunded. After 14 days, purchases are final.

### Is the icon data licensed?

Every icon keeps its original open-source license from its source collection, nothing changes there. What you are paying for is hosted API access: uptime, search infrastructure, and support.