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. New here? Start with the agent overview.

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.

create_image_uploadUpload a local image file. Returns a self-authorizing curl command your agent can run straight away — no API key handling. Gives back an imageId.

add_imageRegister an image into a brand's library from a public URL (re-hosted, tagged, subject cut-out). Returns an imageId for generate_carousel or schedule_text_post.

list_imagesList a brand's images (uploaded + scraped) with their imageIds.

generate_carouselGenerate a full carousel for a brand from a one-line brief. Claude writes the copy and picks the layouts. Pass imageIds to build it around specific images. 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.

list_social_accountsThe social accounts connected to your brands (connect them in the app first, under Settings or the brand page).

schedule_carouselAuto-publish a carousel to connected accounts — pick per-account formats (static, animated, video) and a time, or post immediately.

schedule_text_postAuto-publish a regular post: text plus an optional library image. X and Facebook take text alone; Instagram needs the image.

list_scheduled_posts / cancel_scheduled_postTrack scheduled and published posts (status, permalink, errors), or cancel a pending one.

Uploading local images

MCP tool arguments are JSON, so binary files don't travel through them. Just ask your agent — it calls create_image_upload, which hands back a ready-to-run command. The link authorizes itself and expires in 30 minutes, so your agent never needs your API key (it lives in your MCP client config, out of the model's reach).

create_image_upload { brandId }  →  { curl: "..." }

curl -sS -F file=@photo.jpg \
  "https://supaslides.app/api/public/images?ticket=..."   →  { imageId }

Scripting it yourself instead? POST the same multipart request with your API key and an explicit brandId:

curl -F file=@photo.jpg -F brandId=YOUR_BRAND_ID \
  -H "Authorization: Bearer sk_YOUR_KEY" \
  https://supaslides.app/api/public/images

JPG, PNG or WebP. Send a downscaled image (keep it under ~4 MB); it's re-hosted, tagged, and a subject cut-out is made automatically. Either way you get an imageId for generate_carousel's imageIds or schedule_text_post. Already have a hosted image? Use add_image with its URL.

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