Skip to main content

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 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.

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.png and turn it into a YouTube visualizer with ken_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_job and wait_for_job point 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_upload and runs the returned curl, which posts the file to the CoverScale API. One whose host passes a download link (ChatGPT does) calls upload_attached_file instead. Do not expect the upload to go to storage.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_file is 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 seeWhat 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 outAPI access is not on for your account. Contact us to turn it on.
insufficient_creditsBuy credits at coverscale.app/pricing.
grant_daily_limitThe connection reached its daily limit. Raise it in Settings → Connected apps, or wait for the next UTC day.
insufficient_scopeThe connection was approved without Generate assets. Connect it again with Generate assets ticked.
"This request has expired" on the consent pageConsent links last ten minutes and work once. Start the connection again from your assistant.

The full tool list is in the tools reference.