{"id":"28217ff9-b6c2-487b-8446-40c0a2c4277d","slug":"curio-mcp-extension","kind":"mcp","name":"curio-mcp-extension","summary":"Connect your AI to Curio — a design-style library for AI agents (MCP server, OAuth). Gemini CLI extension + install guide for Claude/Cursor/Codex/Kimi.","owner":"designbycurio","repoUrl":"https://github.com/designbycurio/curio-mcp-extension","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-06-10T07:34:44.000Z","addedAt":"2026-10-13T22:04:19.567Z","logoUrl":"https://avatars.githubusercontent.com/u/330698674?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","design-media"],"tags":[],"runtime":"remote","local":false,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T12:04:49.501Z","sample":false,"url":"https://conduits.dev/tools/curio-mcp-extension","language":"","transports":["http"],"install":{"remoteUrl":"https://mcp.designbycurio.com/mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Curio MCP\n\nConnect your AI to [Curio](https://designbycurio.com) — a design-style library\nbuilt for AI agents. Hundreds of tokenized design styles (real design\nmovements, brands, cultural traditions), each with a machine-readable spec\nyour agent can apply directly to slides, websites, and products.\n\n- **Endpoint**: `https://mcp.designbycurio.com/mcp` (streamable HTTP)\n- **Auth**: OAuth sign-in for most clients. A client that can't open a browser to sign in uses a personal [API key](#api-key) instead. Searching and browsing are free; 1 credit unlocks a style for good ([credit packs](https://designbycurio.com/pricing), never expire).\n- **Protocol**: MCP 2026-07-28 and the 2025 revisions\n- **Docs**: [designbycurio.com/docs](https://designbycurio.com/docs)\n\n## Tools\n\n| Tool | What it does | Cost |\n|---|---|---|\n| `search_styles` | Keyword + facet search over the library | free |\n| `list_styles` | Browse / paginate, filtered by facets | free |\n| `get_style` | Metadata + preview image for one style | free |\n| `get_style_spec` | Full design spec (DESIGN.md) for a style you've unlocked; for a locked style it returns the cost and your balance instead | free |\n| `unlock_style` | Unlock a style for good and return its spec — your AI asks you first | 1 credit, once per style |\n| `get_balance` | Your credit balance and how many styles you've unlocked | free |\n\nYour AI never spends a credit on its own: `get_style_spec` only reads, and `unlock_style` is meant to be called after you agree. Unlocking a style you already own costs nothing.\n\n## Install\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/designbycurio/curio-mcp-extension\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http curio https://mcp.designbycurio.com/mcp\n```\n\n### Claude.ai / Claude Desktop\n\nSettings → Connectors → **Add custom connector** → `https://mcp.designbycurio.com/mcp`\n\n### Cursor\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=curio&config=eyJ1cmwiOiJodHRwczovL21jcC5kZXNpZ25ieWN1cmlvLmNvbS9tY3AifQ==)\n\nThe button opens Cursor and adds Curio for you. Or add it to `~/.cursor/mcp.json` yourself — Cursor opens a browser to sign in on first use:\n\n```json\n{\n  \"mcpServers\": {\n    \"curio\": { \"url\": \"https://mcp.designbycurio.com/mcp\" }\n  }\n}\n```\n\n### VS Code (Copilot)\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Curio-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=curio&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.designbycurio.com%2Fmcp%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Curio-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=curio&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.designbycurio.com%2Fmcp%22%7D&quality=insiders)\n\nThe button opens VS Code and installs Curio in your user MCP config. Or add it to `.vscode/mcp.json` yourself — VS Code opens a browser to authorize on first connect:\n\n```json\n{\n  \"servers\": {\n    \"curio\": { \"type\": \"http\", \"url\": \"https://mcp.designbycurio.com/mcp\" }\n  }\n}\n```\n\n### Codex (CLI / IDE extension)\n\n```bash\ncodex mcp add curio --url https://mcp.designbycurio.com/mcp\n```\n\n### Kimi Code CLI\n\n```bash\nkimi mcp add --transport http --auth oauth curio https://mcp.designbycurio.com/mcp\n```\n\n### ChatGPT\n\nSettings → Apps & Connectors → **Developer mode** → add `https://mcp.designbycurio.com/mcp`.\n\n## API key\n\nSome clients can't open a browser to sign in — they only have a field for a token (ZCode, WorkBuddy, Qoder, Trae, Cherry Studio, Antigravity, Manus…). For those, create a personal API key and send it as a request header. Clients that can sign in with OAuth don't need one.\n\n1. Sign in at designbycurio.com and open [Account → Connected apps → API keys](https://designbycurio.com/account/connected#api-keys). Name the key after the client and create it.\n2. Copy the key straight away — it starts with `curio_sk_` and is shown only once.\n3. In the client's MCP settings, add the server URL with this header:\n\n```\nAuthorization: Bearer curio_sk_…\n```\n\nMost clients take a JSON block like this. Some name the address field `serverUrl` or `httpUrl`, or ask for a transport type — pick **streamable HTTP**.\n\n```json\n{\n  \"mcpServers\": {\n    \"curio\": {\n      \"url\": \"https://mcp.designbycurio.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer curio_sk_…\" }\n    }\n  }\n}\n```\n\n**Claude Code** takes the header on the command line:\n\n```bash\nclaude mcp add --transport http curio https://mcp.designbycurio.com/mcp --header \"Authorization: Bearer curio_sk_…\"\n```\n\n**Codex** reads the key from an environment variable, so it never sits in a config file:\n\n```bash\nexport CURIO_API_KEY=curio_sk_…\ncodex mcp add curio --url https://mcp.designbycurio.com/mcp --bearer-token-env-var CURIO_API_KEY\n```\n\n**VS Code** can prompt for the key and store it securely instead of writing it into `mcp.json`:\n\n```json\n{\n  \"inputs\": [\n    { \"type\": \"promptString\", \"id\": \"curio-key\", \"description\": \"Curio API key\", \"password\": true }\n  ],\n  \"servers\": {\n    \"curio\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.designbycurio.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer ${input:curio-key}\" }\n    }\n  }\n}\n```\n\n**Two kinds of key.** A read-only key (the default) can search, browse and fetch styles you've already unlocked, and never spends credits. Tick **Allow it to spend credits to unlock styles** when you create a key and your AI may also call `unlock_style` — after asking you, same as over OAuth. Treat a key like a password: don't paste it into a chat or commit it to a repo. Revoke it any time on the same page; clients using it stop working within 30 seconds.\n\n## Example prompts\n\n- *\"Find a Japanese minimal style and restyle my landing page with it.\"*\n- *\"Browse Curio for an 80s retro style that works for a dashboard.\"*\n- *\"Fetch the bauhaus-weimar spec and apply it to my slides.\"*\n- *\"How many Curio credits do I have left?\"*\n\n## Links\n\n[Website](https://designbycurio.com) · [Gallery](https://designbycurio.com/gallery) · [Pricing](https://designbycurio.com/pricing) · [Docs](https://designbycurio.com/docs) · [Privacy](https://designbycurio.com/privacy) · [Terms](https://designbycurio.com/terms) · support@designbycurio.com\n"}