[Gradients Studio MCP]
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.
[Gradients Studio MCP]
- 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
Or as a plugin, which adds a skill that tells Claude when to reach for it:
Cursor: Add to Cursor, or add to ~/.cursor/mcp.json:
Codex
VS Code
Gemini CLI
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>:
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
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
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 plugin
gemini-extension.json, GEMINI.md: the Gemini CLI extension
glama.json: the Glama listing
llms-install.md: install instructions written for agents
Support
[email protected] · Privacy · Terms
The files in this repository are MIT licensed; see LICENSE.