Ask for an icon.
Get it in your code.
- Works in:
- Claude
- Claude Code
- ChatGPT
- Codex
- Cursor
Sign in with Google or GitHub.
Set up in one line
Your agent searches icons, fetches the SVG and finds brand logos. Sign in with Google or GitHub to start free.
/plugin marketplace add thetechbasket/allsvgicons-skills
/plugin install allsvgicons@allsvgiconsType 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. Skill for other agents (Cursor, Codex, Gemini CLI and more): npx skills add thetechbasket/allsvgicons-skills, then add the server.
Settings > Connectors > Add custom connector
Server URL: https://i.allsvgicons.com/mcp
Then Connect and sign in with Google or GitHub.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 mcp add allsvgicons --url https://i.allsvgicons.com/mcp
codex mcp login allsvgicons{
"mcpServers": {
"allsvgicons": {
"url": "https://i.allsvgicons.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to .cursor/mcp.json or any MCP JSON config. The API key comes with MCP Pro.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"allsvgicons": { "type": "remote", "url": "https://i.allsvgicons.com/mcp" }
}
}
Then run: opencode mcp auth allsvgiconsAdd to opencode.json in your project, then sign in with Google or GitHub.
What your agent shows you
Connect your agentIn Claude and ChatGPT, results open as a picker, not a wall of text. Free on every plan.
allsvgiconsallsvgiconsThe site is free for everyone. Pro helps keep it that way.
QuestionsPro only adds to the MCP server. Nothing on the website moves behind it.
| MCP server for agents | Free | Pro |
|---|---|---|
| Search and fetch any of 414,562 icons | ||
| Tool calls | 20 a day | No daily cap |
| Sign in | Google or GitHub | API key, never signs out |
| Icon picker and brand logo widgets | ||
| Updates and email support | Updates | Lifetime |
Everything on allsvgicons.com stays free with no account: search, copy, download, tools.
Pro is for agents that search all day. Each purchase pays for the servers behind the free site and the free plan.
- $29, first 5042 of 50 left
- $49 lifetimenext 50 seats
- $9 a month or $79 a yearafter that
Tools your agent gets
Read as Markdown
search_iconsSearch by intentFull-text search across 414k+ icons. "shopping cart outline" → the right icon, first try.
search_icons(query: string, prefix?: string, limit?: number) → icon namesInputs: query (required, keyword). prefix (optional, one icon set, e.g. "lucide"). limit (optional, 1 to 20, default 20).
Returns: JSON { "icons": [{ "name": "prefix:name" }] }. No match returns an empty list, not an error.
get_iconFetch the SVGRaw SVG by "prefix:name", ready to paste into the file your agent is editing.
get_icon(name: "prefix:name") → SVG markupInputs: name (required, full icon name, e.g. "lucide:rocket").
Returns: The SVG markup as text. Icons over 32 KB return their size and a direct .svg URL instead. An unknown name returns "not found" plus the closest names.
find_brand_logoFind a brand logoEvery version of a company logo across packs (color, mono, wordmark), with its official hex color.
find_brand_logo(brand: string) → { prefix:name, style }[] + hex colorInputs: brand (required, brand name or domain, e.g. "Stripe" or "stripe.com", max 100 characters).
Returns: JSON { "brand", "color": { "hex", "source" }, "packs": [{ "prefix", "pack", "icons": [{ "name", "style" }] }], "note" }. Unknown brands return empty packs.
list_collectionsBrowse all packsEvery pack with its prefix, name, and icon count. 243 collections.
list_collections() → { prefix, name, total }[] by categoryInputs: None.
Returns: Text list of every icon set grouped by category, with prefix, name and icon count. Does not count toward usage limits.
send_feedbackTalk to usFeedback straight from the agent session. No context switch.
send_feedback(message: string) → confirmationInputs: message (required, max 1000 characters).
Returns: A short confirmation. One way: for a reply, email [email protected]. Does not count toward usage limits.
Calling the API directly
- Endpoint
- POST https://i.allsvgicons.com/mcp
- Format
- JSON-RPC 2.0 over HTTPS (MCP Streamable HTTP). Send Content-Type: application/json and Accept: application/json, text/event-stream. One request per call, no batches.
- Auth
- Authorization: Bearer <token>. Get the token with OAuth 2.1 (authorization code with PKCE): discovery at https://i.allsvgicons.com/.well-known/oauth-authorization-server, dynamic client registration supported. Access tokens last 1 hour, refresh tokens 180 days.
- Limits
- Free: 20 tool calls per day (UTC). Pro and API keys: 60 tool calls per minute. list_collections and send_feedback are not counted. Every counted response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset.
- Example
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_icon","arguments":{"name":"lucide:rocket"}}}- Errors
- HTTP 401: Missing, expired or invalid token. Refresh the OAuth token and retry.
- HTTP 400: Malformed JSON-RPC, or a batched request.
- Tool result text: Limit reached: the message says when it resets. Not an HTTP error, so clients show it to the user.
- Invalid arguments: A missing or wrong field: the error names the field.
- HTTP 500: Server error. Retry later.
allsvgicons MCP vs building it yourself
| Need | allsvgicons MCP | DIY or raw API |
|---|---|---|
| Find the right icon for a description | search_icons does full-text intent matching in one call | Agent must fetch a pack index, then guess a filename |
| Get usable SVG markup | get_icon returns ready-to-paste SVG | Agent parses a sprite or icon-font mapping by hand |
| Know which packs exist | list_collections returns prefix, name and icon count per pack | Agent cross-references separate npm packages and READMEs |
| Rate limits | Free plan has a daily cap the agent can see. Pro: no daily cap | Hard daily caps or no limit visibility, agent loops blind |
| Setup | One MCP config block, works over HTTP transport | Install an SDK, write a wrapper tool, maintain it |
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 [email protected] 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.