Developers

The Supaslides MCP server

Connect Claude Code, Cursor, or any MCP client to your Supaslides account. Ask your assistant to turn a URL into a brand, generate on-brand carousels, export them as images or video, and share claimable decks. Every tool runs on your account and within your plan limits.

1. Create an API key

Go to Settings → API keys and create a key. It is shown once; treat it like a password. Revoking a key disconnects anything using it.

2. Connect your client

Claude Code:

claude mcp add --transport http supaslides https://supaslides.app/mcp \
  --header "Authorization: Bearer sk_YOUR_KEY"

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "supaslides": {
      "url": "https://supaslides.app/mcp",
      "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
    }
  }
}

Endpoint: https://supaslides.app/mcp(Streamable HTTP). claude.ai custom connectors need OAuth and are coming soon; today the server authenticates with API keys, which Claude Code and Cursor support. Brand extraction can run up to two minutes, so raise your client's tool timeout if it defaults low (Claude Code: MCP_TOOL_TIMEOUT).

3. Tools

create_brandExtract a brand theme (colors, fonts, logo, voice, business profile) from a website URL and save it, with 5 starter ideas. 60-120s.

list_brandsList your brands.

generate_carouselGenerate a full carousel for a brand from a one-line brief. Claude writes the copy and picks the layouts. 15-40s.

list_carousels / get_carouselBrowse your carousels; get slides, caption, and the editor link.

export_carouselExport as PNG ZIP (PDF for LinkedIn) with a download link, or queue an animated video render.

check_exportPoll a video export and fetch its download link when done.

share_carouselMint a claimable share link: a personalized landing page where the recipient can preview the deck and claim it into their own account.

get_share_status / list_shares / revoke_shareTrack views and claims on your share links, or deactivate them.

Limits & billing

MCP calls use the same allowances as the app: your plan's brand limit, monthly carousel quota, platform availability, and watermark rules all apply. Quota errors say exactly what ran out. Exports are kept for 48 hours; download links are short-lived and can be re-issued with check_export.

No account yet? Try Supaslides free · questions: support@supaslides.app