Gradients Studio
Gradient backgrounds with real grain, pixel and dither finishes. Free previews, no key needed.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http gradients-studio 'https://www.gradients.studio/mcp' --header 'Authorization: <Optional. Only for sized exports (download URLs); previews, palettes and suggestions work without it. Bearer <key> from gradients.studio (studio → account menu → API keys).>'
{
"mcpServers": {
"gradients-studio": {
"type": "http",
"url": "https://www.gradients.studio/mcp",
"headers": {
"Authorization": "<Optional. Only for sized exports (download URLs); previews, palettes and suggestions work without it. Bearer <key> from gradients.studio (studio → account menu → API keys).>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Gradients Studio MCP
Gradient backgrounds for coding agents. Describe the background in plain words ("dark, grainy, a bit like Linear") and your agent previews it, adjusts it, and drops the finished file into your repo at the exact size the layout needs: a website hero, an OG image, a launch post, a slide.
- Server:
https://www.gradients.studio/mcp(remote, Streamable HTTP, stateless) - No key to start: previews, palettes and suggestions work without an account.
- Exports: exact-size files with a download URL need a free API key; 5 free a month, unlimited on Pro.
- Docs: https://www.gradients.studio/mcp · agent install guide: llms-install.md
This repository holds the server's public listing files and docs only. The service itself is hosted; there is nothing to build or run.
Install
Claude Code
claude mcp add gradients --transport http https://www.gradients.studio/mcp
Or as a plugin, which adds a skill that tells Claude when to reach for it:
/plugin marketplace add anusandhan/gradients-studio-mcp
/plugin install gradients-studio@gradients-studio
Cursor: Add to Cursor, or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gradients": { "url": "https://www.gradients.studio/mcp" }
}
}
Codex
codex mcp add gradients --url https://www.gradients.studio/mcp
VS Code
code --add-mcp '{"name":"gradients","type":"http","url":"https://www.gradients.studio/mcp"}'
Gemini CLI
gemini extensions install https://github.com/anusandhan/gradients-studio-mcp
Windsurf, Cline, Claude Desktop and others: add a remote server named gradients with the URL above. Per-client details are in llms-install.md.
Add a key for exports
- Create a key at https://www.gradients.studio/app?keys=1 (sign in, then account menu → API keys). It is shown once.
- Send it as
Authorization: Bearer <key>:
claude mcp remove gradients
claude mcp add gradients --transport http https://www.gradients.studio/mcp --header "Authorization: Bearer <key>"
In JSON configs, add "headers": { "Authorization": "Bearer <key>" } next to "url". With the Claude Code plugin, set GRADIENTS_STUDIO_KEY in your environment instead.
Tools
| Tool | What it does | Key |
|---|---|---|
suggest_settings | Turns a brief ("dark, premium fintech hero, a bit retro") into two or three starting settings. Understands jobs, moods, colors, product names, styles and finishes. | No |
list_palettes | The studio's sixteen palettes, palettes behind sites people admire (Linear, Stripe, Raycast…), and six tuned starting points for common jobs. Your saved palettes too, with a key. | No |
render_gradient | Renders with every dial the studio has: blobs, stripes, clouds or rays; grain; pixel and dither finishes; shape overlays or your logo SVG. Without size: a free 960px preview inline. With size: an exact-size export and a download URL valid for 24 hours. | Only for size |
Every result includes the settings (send them back to iterate) and a studio link to take over in the browser. Asking for the same export again within 24 hours returns the same URL and costs nothing.
Example prompts
- "Add a dark, grainy hero background to the landing page, 2560×1440, something like Linear."
- "Make a 1200×630 OG image background in our brand colors from
tailwind.config.ts." - "Give the pricing section a soft pastel gradient background; preview three options first."
- "Make a LinkedIn launch post background, 1080×1350, with our logo as a subtle outline."
- "Generate a retro pixel-finish wallpaper for the 404 page."
What it makes
| Website hero | Launch post | Deck slide |
|---|---|---|
Limits
- Without a key: 30 calls a minute and 300 a day per address.
- With a key: previews are free; sized exports use the account's monthly pool (5 free, unlimited on Pro), with a cap of 200 sized exports a day on every plan.
- Pixel and dither finishes preview free and export on Pro.
Files in this repo
server.json: the MCP Registry entry.claude-plugin/,.mcp.json,skills/: the Claude Code plugin and its marketplace.codex-plugin/: the Codex plugingemini-extension.json,GEMINI.md: the Gemini CLI extensionglama.json: the Glama listingllms-install.md: install instructions written for agents
Support
hello@gradients.studio · Privacy · Terms
The files in this repository are MIT licensed; see LICENSE.
الأسئلة الشائعة
ما هو Gradients Studio؟
Gradient backgrounds with real grain, pixel and dither finishes. Free previews, no key needed.
كيف أثبّت Gradients Studio؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http gradients-studio 'https://www.gradients.studio/mcp' --header 'Authorization: <Optional. Only for sized exports (download URLs); previews, palettes and suggestions work without it. Bearer <key> from gradients.studio (studio → account menu → API keys).>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Gradients Studio إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Gradients Studio مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Gradients Studio؟
ينشره anusandhan. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.