MCP server
Connect an AI assistant to your CoverScale account and ask it to make release assets: avatars, banners, vinyl mockups, Spotify Canvas, YouTube visualizers, Apple Music motion artwork and Reels, from your own artwork or from assets already in your library.
Endpoint and sign-in
https://mcp.coverscale.app
The address is the host itself: there is no /mcp path on the end. The server speaks streamable HTTP. You never paste a key: the first time an assistant connects, it opens a CoverScale page where you sign in and choose what it may do. It then holds a token for your account until you disconnect it.
Your account needs API access for the connection to be approved, the same as for an API key. API keys (cs_live_…) are for the REST API and are refused by the MCP server.
Connect
- Claude Code
- claude.ai
- Cursor
- Codex
- Windsurf
- Any other client
- ChatGPT
claude mcp add --transport http coverscale https://mcp.coverscale.app
Then run /mcp in Claude Code, pick coverscale and choose Authenticate. Your browser opens the CoverScale consent page.
In Settings → Connectors, choose Add custom connector, name it CoverScale and enter https://mcp.coverscale.app. Choose Connect on the new connector to sign in.
Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"coverscale": {
"url": "https://mcp.coverscale.app"
}
}
}
Cursor shows Needs login next to the server in Settings → MCP; choose it to sign in.
codex mcp add coverscale --url https://mcp.coverscale.app
codex mcp login coverscale
Add the server to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"coverscale": {
"serverUrl": "https://mcp.coverscale.app"
}
}
}
Refresh the MCP servers in Windsurf's settings and sign in when prompted.
Use the server URL https://mcp.coverscale.app with streamable HTTP. There is no path after the host and no API key. The client opens the CoverScale sign-in page the first time it connects. A desktop or command-line client may send you to http://127.0.0.1 or http://localhost on any port afterwards; that redirect is accepted.
Turn on Developer mode under Settings → Apps & Connectors → Advanced settings, then create a connector with the URL https://mcp.coverscale.app and OAuth authentication. ChatGPT opens the CoverScale consent page when you add it.
The consent page
The consent page shows which app is asking, where you are sent afterwards, and what it may do:
- See your credit balance and usage, see your generations and their results, browse your asset library, and upload images and audio to use in generations — always granted. There is no separate permission for viewing the account itself.
- Generate assets (spends credits) — untick it for a read-only connection.
- Daily credit limit — 10, 50 (the default) or 200 credits a day, or no limit. Generations past the limit are refused until the next UTC day.
An app that registered itself is marked Not verified by CoverScale: anyone can choose its name, so only approve it if you just asked that app to connect.
Try it
- "Show me my CoverScale credits and what a Spotify Canvas costs."
- "Make Spotify avatars and banners from the cover in my library called Midnight Drive."
- "Upload
~/Desktop/cover.pngand turn it into a YouTube visualizer withken_burns, muxed to~/Desktop/single.mp3." - "Which motion styles can I use for Apple Music motion artwork?"
Good to know
- Generations spend credits. The assistant is told to confirm the price with you before it generates anything, and each connection is held to its daily limit regardless. That confirmation is text. It is told not to draw a preview of the vinyl, sleeve, or any other result; the only render is the file CoverScale returns after you approve.
- Results show in the chat. When a job finishes, a client that supports MCP Apps (Claude, ChatGPT, Cursor, VS Code, and others) draws a card with each image or video, because
get_jobandwait_for_jobpoint at a small result page the server provides. The page loads files only from the CoverScale API and cannot make other requests. Every client also gets the image itself in the tool result, and each file as a link named with its filename. A video comes back as that link plus one frame of the clip. A URL expires after 24 hours; ask the assistant for the job again for a fresh one. - Cover text stays. A vinyl mockup, and every other generation, keeps the typography on the artwork. Spotify Canvas is the exception: it removes the text when the account can, and you can ask to keep it.
- Library assets made before late October may have no text. A Spotify Canvas saved from the web app back then kept only the text-free artwork as its source. Generating from that library asset reuses it, text and all. To keep the text, attach the original file in the chat instead of choosing the library asset.
- Files you attach take whichever path that assistant can actually do. One that can run a command calls
create_uploadand runs the returnedcurl, which posts the file to the CoverScale API. One whose host passes a download link (ChatGPT does) callsupload_attached_fileinstead. Do not expect the upload to go tostorage.googleapis.com; a sandbox is often refused there. Pasting the image as base64 does not work for a cover: a few megabytes of text will not fit in the tool call.upload_fileis only for a small file the assistant already holds. Uploads are deleted after 24 hours. - Disconnecting is under Settings → Connected apps on coverscale.app, where you can also change a connection's daily limit. A disconnected app stops working within about a minute. That removes the connection, not the app's registration. A registration that never finished sign-in is deleted after 24 hours. One that did finish stays, and is harmless once its connection is disconnected.
- Connections last until you disconnect them or for 90 days, whichever comes first; then the assistant asks you to sign in again.
Troubleshooting
| What you see | What to do |
|---|---|
| "re-authorize the CoverScale connector" | The connection was revoked, expired or replaced. Reconnect from your assistant (in Claude Code, /mcp → Authenticate). |
api_access_disabled, or Approve is greyed out | API access is not on for your account. Contact us to turn it on. |
insufficient_credits | Buy credits at coverscale.app/pricing. |
grant_daily_limit | The connection reached its daily limit. Raise it in Settings → Connected apps, or wait for the next UTC day. |
insufficient_scope | The connection was approved without Generate assets. Connect it again with Generate assets ticked. |
| "This request has expired" on the consent page | Consent links last ten minutes and work once. Start the connection again from your assistant. |
The full tool list is in the tools reference.