Gradiently has an HTTP API and a hosted MCP server. Connect an assistant with OAuth sign-in or a scoped workspace API key. The server accepts OAuth access tokens and workspace API keys. Both use the same permissions, licences, credits and limits.
Add a custom connector with ChatGPT: https://; Claude: https:// and choose OAuth sign-in. Sign in to Gradiently, choose a workspace and review its permissions. Only workspace owners and admins can connect an assistant. Connections expire after one hour and renew automatically for up to 30 days. Revoke a connection in Settings › API and agents to stop both its access and renewal immediately.
What you can do
- Search the Market and read any public Mark's full recipe.
- Generate brand candidates from a name and a description, then adopt one: a draft Mark, a brand and three starter designs in one step.
- Make designs with Gradiently's own Designer, with the layout engine, or from a template, and get back a link that opens in the Studio.
- Edit saved designs by element, change their words, save copies in other sizes and put a different Mark on them.
- Render a saved design to PNG or PDF, or publish a view link for it.
MCP or the API
MCP server
- For AI assistants that support remote MCP servers.
- One address:
https://.gradiently.design/ api/ mcp - Tools find your brand, save designs and return Studio links for you.
- Best when you want to ask for work in plain words.
API
- For scripts, back ends and automations.
- JSON over HTTPS under
https://.gradiently.design/ api - You choose the brand, send the design document and handle each response.
- Best when you need exact, repeatable control.
The MCP tools are built on the API. A tool call makes the same requests your code would, with the same key, so it counts against the same limits and fails with the same messages.
Quick start
- 1
Create a key
In Gradiently, open Settings › API and agents, choose the workspace, name the key after where you'll use it, pick what it can do and select Create key. Copy the key when it appears: it is shown only once. Only owners and admins can create keys.
- 2
Connect your assistant
In Claude Code, add Gradiently as a remote MCP server with your key in the Authorization header (the command is below). Other clients are covered on MCP and AI assistants.
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"To call the API instead, send the same header with each request:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"marks:read).How a key acts
A key acts as the person who created it, inside the one workspace it was created for. It can never reach another workspace, even one its creator belongs to. It works only while its creator is still an owner or admin of that workspace and their account is active; if they are removed, demoted or switched off, the key stops working.
- Designs, brands and uploads a key makes belong to the workspace, exactly as if its creator had made them in the app.
- Marks a key claims are held by its creator, never by the workspace, and any licence stays theirs.
- Designer work a key starts spends the workspace's AI credits, like the Designer in the Studio.
- A key cannot manage keys, change the account, reach billing or give a Mark away. API keys and scopes lists what it can never do.
The rest of the docs
- MCP and AI assistants: connecting Claude Code and other clients, every tool with its inputs and scopes, and example prompts.
- API reference: the base URL, authentication, every endpoint a key can call, errors, rate limits and pagination.
- API keys and scopes: creating, rotating and revoking keys, what each scope allows and how to keep keys safe.
- New to MCP? What is MCP explains it in plain words, and modelcontextprotocol.io has the specification.
Stuck, or missing something you need? Send us a request and a person will reply.