Curio — design style library
Design-style library for AI agents: find a style by use or mood, preview it, apply its spec.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http curio-design-style-library 'https://mcp.designbycurio.com/mcp' --header 'Authorization: <Optional — leave empty to sign in with OAuth. For clients that can'\''t open a browser: "Bearer " plus a personal API key (curio_sk_…) created at designbycurio.com/account/connected. Keys are read-only unless you allow unlocking when you create one.>'
{
"mcpServers": {
"curio-design-style-library": {
"type": "http",
"url": "https://mcp.designbycurio.com/mcp",
"headers": {
"Authorization": "<Optional — leave empty to sign in with OAuth. For clients that can't open a browser: \"Bearer \" plus a personal API key (curio_sk_…) created at designbycurio.com/account/connected. Keys are read-only unless you allow unlocking when you create one.>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Curio MCP
Connect your AI to Curio — a design-style library built for AI agents. Thousands of design styles (real design movements, brands, cultural traditions), each with a machine-readable spec your agent can apply directly to slides, websites, and products.
- Find the right style: search in English or Chinese, or filter by what you're making (slides, websites, apps, stores, articles, posters…) and the feel you want (minimal, luxury, playful, retro, futuristic…).
- See it before you pick it: every style comes with a cover image and, on request, screenshots of real layouts — slide cover, content and data slides, a dashboard, a pricing page, an article.
- Apply it exactly: fetch the full design spec (DESIGN.md) and your AI uses its exact colors, type, spacing and components.
- Endpoint:
https://mcp.designbycurio.com/mcp(streamable HTTP) - Auth: OAuth sign-in for most clients. A client that can't open a browser to sign in uses a personal API key instead. Searching, browsing and previews are free; 1 credit unlocks a style for good (credit packs, never expire). Out of credits? Your AI gives you a link to buy more.
- Protocol: MCP 2026-07-28 and the 2025 revisions
- Docs: designbycurio.com/docs
Tools
| Tool | What it does | Cost |
|---|---|---|
search_styles | Keyword search (English or Chinese), with filters: use (what you're making), mood, kind (where the style comes from), color, era, region, dark | free |
list_styles | Browse / paginate with the same filters | free |
get_style | Metadata + cover image for one style; pass scenes for screenshots of real layouts (slide-cover, slide-content, slide-data, dashboard, price, article, or all) | free |
get_style_spec | Full design spec (DESIGN.md) for a style you've unlocked; for a locked style it returns the cost, your balance and a link to buy credits | free |
unlock_style | Unlock a style for good and return its spec — your AI asks you first | 1 credit, once per style |
get_balance | Your credit balance, how many styles you've unlocked, and a link to buy more | free |
Your 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.
Install
Gemini CLI
gemini extensions install https://github.com/designbycurio/curio-mcp-extension
Claude Code
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp
Claude.ai / Claude Desktop
Settings → Connectors → Add custom connector → https://mcp.designbycurio.com/mcp
Cursor
The 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:
{
"mcpServers": {
"curio": { "url": "https://mcp.designbycurio.com/mcp" }
}
}
VS Code (Copilot)
The 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:
{
"servers": {
"curio": { "type": "http", "url": "https://mcp.designbycurio.com/mcp" }
}
}
Codex (CLI / IDE extension)
codex mcp add curio --url https://mcp.designbycurio.com/mcp
Kimi Code CLI
kimi mcp add --transport http --auth oauth curio https://mcp.designbycurio.com/mcp
ChatGPT
Settings → Apps & Connectors → Developer mode → add https://mcp.designbycurio.com/mcp.
API key
Some 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.
- Sign in at designbycurio.com and open Account → Connected apps → API keys. Name the key after the client and create it.
- Copy the key straight away — it starts with
curio_sk_and is shown only once. - In the client's MCP settings, add the server URL with this header:
Authorization: Bearer curio_sk_…
Most clients take a JSON block like this. Some name the address field serverUrl or httpUrl, or ask for a transport type — pick streamable HTTP.
{
"mcpServers": {
"curio": {
"url": "https://mcp.designbycurio.com/mcp",
"headers": { "Authorization": "Bearer curio_sk_…" }
}
}
}
Claude Code takes the header on the command line:
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp --header "Authorization: Bearer curio_sk_…"
Codex reads the key from an environment variable, so it never sits in a config file:
export CURIO_API_KEY=curio_sk_…
codex mcp add curio --url https://mcp.designbycurio.com/mcp --bearer-token-env-var CURIO_API_KEY
VS Code can prompt for the key and store it securely instead of writing it into mcp.json:
{
"inputs": [
{ "type": "promptString", "id": "curio-key", "description": "Curio API key", "password": true }
],
"servers": {
"curio": {
"type": "http",
"url": "https://mcp.designbycurio.com/mcp",
"headers": { "Authorization": "Bearer ${input:curio-key}" }
}
}
}
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.
Example prompts
- "Find a Japanese minimal style and restyle my landing page with it."
- "Show me how the Swiss International style looks on slides before I pick it."
- "Find a luxurious style for my pitch deck."
- "找一个适合做 PPT、显高级的风格。"
- "Browse Curio for an 80s retro style that works for a dashboard."
- "Fetch the bauhaus-weimar spec and apply it to my slides."
- "How many Curio credits do I have left?"
Links
Website · Gallery · Pricing · Docs · Privacy · Terms · support@designbycurio.com
Frequently asked questions
What is Curio — design style library?
Design-style library for AI agents: find a style by use or mood, preview it, apply its spec.
How do I install Curio — design style library?
It runs as a remote server. In Claude Code: claude mcp add --transport http curio-design-style-library 'https://mcp.designbycurio.com/mcp' --header 'Authorization: <Optional — leave empty to sign in with OAuth. For clients that can'\''t open a browser: "Bearer " plus a personal API key (curio_sk_…) created at designbycurio.com/account/connected. Keys are read-only unless you allow unlocking when you create one.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Curio — design style library need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Curio — design style library open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Curio — design style library?
It is published by designbycurio. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.