{
  "markdown": "# Svg/icons MCP\n\nThe Svg/icons MCP server connects AI coding tools to [svgicons.com](https://svgicons.com), a catalog of 320K+ open-source SVG icons. Assistants can search icons and icon sets, fetch icon metadata, and get icon recommendations for a UI without any account. With a Pro account (OAuth or a scoped API token), they can also fetch raw SVG markup, render PNG exports, and create, read, extend, and export persistent Icon Collections — including custom-styled icons — so the icon-discovery step never leaves the development workflow.\n\nThe server is hosted, remote MCP over Streamable HTTP (JSON-RPC requests via HTTP `POST`). There is no local install and no local Svg/icons MCP server package.\n\nEndpoint:\n\n```text\nhttps://svgicons.com/mcp\n```\n\nCurrent MCP server version: `0.3.2` (protocol `2025-06-18`).\n\nOfficial MCP Registry name: `com.svgicons/mcp` — see [Official MCP Registry listing](#official-mcp-registry-listing).\n\n[![smithery badge](https://smithery.ai/badge/contact-deyv/svgicons)](https://smithery.ai/servers/contact-deyv/svgicons)\n\n## What This Repo Contains\n\nThis repository documents the hosted MCP endpoint. It contains no server code.\n\n- Client connection instructions and reference configs\n- Live tool reference\n- Authentication and scope guidance\n- Prompting guidance and a prompt library\n- Example workflow documentation\n- Security guidance and troubleshooting\n- Relationship to the REST API and CLI repos\n- Community use case templates\n\nThe live product docs are the source of truth: [MCP server docs](https://svgicons.com/docs/mcp-server) and the [MCP developer overview](https://svgicons.com/developers/mcp).\n\n## Live MCP Tools\n\nThe hosted endpoint exposes exactly these 12 live tools.\n\n**Search and read** (anonymous metadata; raw SVG with Pro):\n\n- `search_icons` — search icon metadata by query, category, or icon set prefix; add `includeSvg` for raw SVG with a Pro token.\n- `search_icon_sets` — search icon sets by name, prefix, author, category, or description to pick a consistent visual family.\n- `get_icon` — fetch one icon by ID; metadata is public, raw SVG requires a Pro token.\n\n**Recommendations** (anonymous):\n\n- `recommend_icons_for_ui` — describe a UI or screen and receive icon candidates with short rationales.\n\n**Icon Collections — create, read, extend** (Pro):\n\n- `create_icon_kit` — create a persistent Icon Collection and optionally seed it with icon IDs.\n- `generate_icon_kit_for_project` — generate an Icon Collection from a project brief, screen list, or required concepts.\n- `list_icon_collections` — list your Icon Collections with icon counts, an optional name/slug filter, and pagination.\n- `get_icon_collection` — read one collection with paginated entries, including custom-icon entries and their customized SVG bodies.\n- `add_icons_to_collection` — add catalog icons to an existing collection; idempotent, already-present icons are skipped.\n- `remove_icon_from_collection` — remove an icon from a collection; entry-precise by default, pass `allVariants: true` to remove every entry of the icon.\n\n**Exports** (Pro):\n\n- `export_icon_png` — render one icon as a PNG file or a ZIP of PNG variants, returned as a JSON-safe base64 payload.\n- `export_icon_collection` — queue an Icon Collection export: SVG folders, SVG sprites, React/Vue/Svelte/Solid/Blade components, Storybook galleries, npm package scaffolds, PNG packs, Iconify JSON, and JSON/license manifests.\n\nSee [docs/TOOLS.md](docs/TOOLS.md) for verified input fields, output notes, access requirements, and safe prompt examples.\n\n### Export behavior worth knowing\n\n- Custom-icon entries in a collection export their customized snapshot under a unique derived filename — the customization is kept, not replaced by the catalog icon.\n- When you do not pass `colorPolicy`, collections that carry styling (an applied style or custom-icon entries) default to `preserve`, so exported files keep the colors the customization defined. Plain collections keep the `currentColor` default. An explicit `colorPolicy` always wins.\n- Use `formats: [\"png\"]` as a shorthand for `png-pack`.\n\n## Access Tiers And Authentication\n\n**Anonymous (no account):** metadata-only access to `search_icons`, `search_icon_sets`, `get_icon`, and `recommend_icons_for_ui`. Anonymous requests are rate-limited per method and currently capped at 10 icons per search or recommendation. Raw SVG, PNG export, and all Icon Collection tools are not available anonymously.\n\n**Pro:** authenticate with either of:\n\n- **OAuth 2.0** — authorization code with PKCE and Dynamic Client Registration. Clients discover the configuration at `https://svgicons.com/.well-known/oauth-authorization-server` (resource metadata at `/.well-known/oauth-protected-resource/mcp`), register dynamically, and send you to svgicons.com to sign in and approve access.\n- **Pro API token** — a scoped personal access token created from your account page, sent as `Authorization: Bearer YOUR_API_TOKEN` in clients that support private headers.\n\nPro raises search caps (up to 50 icons per search) and unlocks raw SVG, PNG export, and the Icon Collection and export tools.\n\nToken scopes — give each client the smallest set it needs:\n\n| Scope | Unlocks |\n| --- | --- |\n| `mcp:use` | Required for any authenticated MCP call. |\n| `search:read` | Search workflows. |\n| `icons:read` | Raw SVG and PNG export inputs. |\n| `collections:read` | Listing and reading Icon Collections. |\n| `collections:write` | Creating and extending Icon Collections. |\n| `exports:create` | PNG export and Icon Collection export workflows. |\n\nThe Pro Plan is €6/$7 per month or €69/$79 lifetime — see [pricing](https://svgicons.com/pricing). On the website, Icon Collections are also available to free Member accounts through a one-time trial allowance of 15 Pro credits; MCP and API access always require a Pro token.\n\nSee [docs/AUTHENTICATION.md](docs/AUTHENTICATION.md) and the [MCP server docs](https://svgicons.com/docs/mcp-server).\n\n## Connect Your Client\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http svgicons https://svgicons.com/mcp\n```\n\nThen run `/mcp` inside Claude Code to complete the OAuth sign-in. To use a Pro API token instead:\n\n```bash\nclaude mcp add --transport http svgicons https://svgicons.com/mcp \\\n  --header \"Authorization: Bearer YOUR_API_TOKEN\"\n```\n\n### Claude.ai and Claude Desktop (custom connector)\n\n1. Open **Customize → Connectors** and click **Add custom connector**.\n2. Enter `https://svgicons.com/mcp` and click **Add**.\n3. Complete the OAuth prompt to sign in to svgicons.com (Dynamic Client Registration — no client ID needed).\n4. Enable the connector per conversation from the **+** menu → **Connectors**.\n\nTeam/Enterprise owners add it under **Organization settings → Connectors → Add → Custom → Web**; members then connect individually.\n\n### Cursor\n\nProject `.cursor/mcp.json` or global `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"url\": \"https://svgicons.com/mcp\"\n    }\n  }\n}\n```\n\nOmit `headers` to use Cursor's OAuth flow, or add a token:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"url\": \"https://svgicons.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"serverUrl\": \"https://svgicons.com/mcp\"\n    }\n  }\n}\n```\n\nOmit `headers` for OAuth, or reference an environment variable:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"serverUrl\": \"https://svgicons.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${env:SVGICONS_API_TOKEN}\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot agent mode)\n\nWorkspace `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"svgicons\": {\n      \"type\": \"http\",\n      \"url\": \"https://svgicons.com/mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT and Codex\n\nChatGPT authenticates through OAuth with Dynamic Client Registration; Codex-style clients can use a bearer token. Follow the website guide: [Use MCP with ChatGPT and Codex](https://svgicons.com/docs/chatgpt-codex-mcp-setup), plus [configs/chatgpt-codex.md](configs/chatgpt-codex.md) and [configs/codex.example.md](configs/codex.example.md).\n\n### Other clients\n\nClients that support remote HTTP MCP servers can connect with the generic shape:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"type\": \"http\",\n      \"url\": \"https://svgicons.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nClients that only launch local command-based MCP servers can bridge with `mcp-remote`:\n\n```json\n{\n  \"mcpServers\": {\n    \"svgicons\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://svgicons.com/mcp\",\n        \"--header\",\n        \"Authorization: Bearer ${SVGICONS_API_TOKEN}\"\n      ],\n      \"env\": {\n        \"SVGICONS_API_TOKEN\": \"YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nMore client guidance: [docs/CLIENTS.md](docs/CLIENTS.md) and [configs/README.md](configs/README.md).\n\n## Official MCP Registry Listing\n\nThe server is published in the [Official MCP Registry](https://registry.modelcontextprotocol.io) as `com.svgicons/mcp`. Verify the live listing:\n\n```bash\ncurl -s \"https://registry.modelcontextprotocol.io/v0/servers?search=com.svgicons\"\n```\n\nDirectories that ingest the official registry (such as PulseMCP) pick the listing up automatically.\n\n## Example Agent Prompts\n\n1. \"Find me a minimal lock icon that works at 16px and add it to my app's Icon Collection.\"\n2. \"Recommend icons for a billing settings page — I need payment method, invoice, and refund concepts — then create a collection called 'Billing UI' with the best ones.\"\n3. \"Export my 'Dashboard' collection as React TypeScript components with a 20px default size and download the PNG pack at 2x density.\"\n\nThe [prompt library](prompts/README.md) includes copyable workflows for search, React components, dashboard navigation, emoji replacement, accessibility review, themeable icons, design-system review, Icon Collections, and PNG export. Start with [search icons](prompts/search-icons.md), then move to code or export prompts only after reviewing the tool calls and selected icons.\n\n## Examples And Use Cases\n\n- [Examples](examples/README.md) show practical hosted MCP workflows. They are documentation examples, not runnable local MCP server apps.\n- [Community use cases](use-cases/README.md) explain how to share workflows safely.\n- [Use-case template](use-cases/TEMPLATE.md) provides a reusable submission format.\n- [GitHub issue templates](.github/ISSUE_TEMPLATE/) support use cases, setup help, feedback, and bug reports.\n\nSample use cases are marked as examples, not real customer submissions. Review generated SVG and code before committing changes.\n\n## Validation\n\nRun local checks before proposing changes:\n\n```bash\nnpm ci\nnpm run validate\n```\n\nCI runs the same validation without live MCP calls, auth tokens, publishing, or deployment.\n\n## Related Repos And Docs\n\n- Website MCP developer page: <https://svgicons.com/developers/mcp>\n- MCP server docs: <https://svgicons.com/docs/mcp-server>\n- ChatGPT and Codex setup docs: <https://svgicons.com/docs/chatgpt-codex-mcp-setup>\n- REST API repo: <https://github.com/svgicons-com/api>\n- CLI repo: <https://github.com/svgicons-com/cli>\n\nRepo roles:\n\n- MCP repo: AI coding tool workflows, hosted MCP setup, prompts, examples, security notes, and troubleshooting.\n- API repo: REST API, OpenAPI, SDK, examples, and direct programmatic integration.\n- CLI repo: terminal workflows, export automation, and project commands.\n\nSee [docs/API_RELATIONSHIP.md](docs/API_RELATIONSHIP.md).\n\n## Security Summary\n\n- Do not paste tokens into public prompts, issues, screenshots, commits, or repos.\n- Use OAuth where supported by the MCP client.\n- Use bearer tokens only in supported clients and keep them private.\n- Give every client the smallest scope set it needs and revoke unused tokens.\n- Review tool calls before approval.\n- Review AI-generated SVG and code before committing.\n- Treat SVG insertion as code and content insertion.\n\nSee [SECURITY.md](SECURITY.md) and [docs/SECURITY.md](docs/SECURITY.md).\n\n## Start Here\n\n- [Authentication](docs/AUTHENTICATION.md)\n- [Tools](docs/TOOLS.md)\n- [Client setup overview](docs/CLIENTS.md)\n- [Config examples](configs/README.md)\n- [Troubleshooting](docs/TROUBLESHOOTING.md)\n- [API relationship](docs/API_RELATIONSHIP.md)\n- [MCP security](docs/SECURITY.md)\n- [Prompting guide](docs/PROMPTING_GUIDE.md)\n- [Prompt library](prompts/README.md)\n- [Examples](examples/README.md)\n- [Community use cases](use-cases/README.md)\n",
  "bytes": 12628,
  "sha": "7d381c9c09b675034f071886846ab9481ec23015b1ded177be1ba6c2e9908019",
  "repo_slug": "svgicons-com/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_svgicons_mcp_d3d442d1/readme"
}