PricingAPI keys
OverviewQuickstartAuthentication
GenerateModelsImagesVideoUploads
JobsJobs and pollingWebhooks
ReferenceErrors and retriesLimitsClient
BillingBilling
Media toolsOverviewAvatarRemix mediaFace swapMusicTimelineVideo captions
MCPOverviewQuickstartOAuthTools and gates
CLIOverviewInstall and loginCommandsAgent skills
API referenceAPI reference
EnterpriseOverviewAgentsFormatsBest practices

MCP

MCP overview

Hosted Sume MCP for Cursor, Claude, and other MCP clients.

Sume has a hosted Model Context Protocol (MCP) endpoint. A person who signs in can make and edit images, videos and audio, and read their balance, models and jobs. It is not necessary to wrap the HTTP API yourself. Crawl and Avatar tools need a Sume API key on https://api.sume.com/mcp.

Production endpoint

text
https://mcp.sume.com/mcp

Use this URL in Cursor, Claude Code, Codex, and other remote MCP clients.

Internal/dev note: https://mcp.dev.sume.com/mcp is for Sume development environments. Public docs and customer configs must use mcp.sume.com.

Choose the right surface

SurfaceWhat it isWhen to use
Hosted MCPRemote HTTP MCP at https://mcp.sume.com/mcpConnect Cursor/Claude/Codex to Sume by signing in (OAuth). Preferred MCP path today. Scripts with an API key use https://api.sume.com/mcp.
Local sume mcpCLI MCP command (stdio client setup)Not launched in the current sumelabs/cli releases (sume mcp doctor → coming_soon). Use hosted MCP or direct CLI commands.
Developer API / CLIhttps://api.sume.com/v1 and sume binaryBackend integrations, scripts, and HTTP submits. Hosted MCP covers most generation families. Image 1.0 / Video 1.0 (images_create / videos_create) stay REST-only.
Studio AgentProduct agent experience in the Sume appIn-product agent workflows. It is not a public MCP connector, and this page does not document it.

Hosted MCP is the supported remote connector today. Local sume mcp is a future CLI surface. Do not document it or configure it as an operational stdio server at this time. The Studio Agent product surface is also not a supported remote connector. Also refer to the CLI overview.

Auth at a glance

AuthHosted MCP capability today
Sign-in (OAuth)mcp:read (required) sees 17 read-only tools. To also see the create and edit tools (41 in all), keep Create and spend credits (mcp:write) on at consent. There is no mcp:paid scope. sume login uses the same sign-in.
API keyThe full tool set on https://api.sume.com/mcp. https://mcp.sume.com/mcp answers an API key with 401 api_key_not_accepted, and a key made on the Open pages gets 403 open_key_route_not_allowed. Paid/write calls still need idempotency_key. The workspace balance and admission are the spend gate.

Sign-in is the path for people, for example Cursor and Claude. API keys are for scripts and servers.

For details, refer to Sign-in and API keys.

What hosted MCP can do today

Hosted MCP does not have full parity with the HTTP API. The live tool ids are underscore names. The server maps dotted aliases (tools.list) to the underscore names.

On a sign-in connection

A sign-in connection (Claude, ChatGPT, Cursor, Codex on https://mcp.sume.com/mcp) lists the tools for making and editing images, videos and audio.

A read-only connection sees 17 tools: the workflow and preset readers (get_workflow_instructions, get_workflow_bundle_file, get_presets, get_preset_instructions), models_explore, balance, list_workspaces, select_workspace, jobs_wait, job_status, jobs_list, jobs_get, jobs_result, usage_get, tts_router_voices, video_frames_get and timeline_get.

With Create and spend credits on, it sees 41 tools. It adds media_upload, media_confirm, media_import_url, jobs_cancel, and these create and edit tools. Most of them spend from the workspace balance.

  • generate_image / generate_video (omit payload.model to route to sume/auto, and get model ids from models_explore)
  • generate_audio for speech and music
  • generate_image_batch, generate_video_batch, generate_audio_batch and execute_preset
  • avatar_image_to_video_create for a talking still
  • remix_video_create, kling_motion_control_create, rmbg_create, video_upscale_create
  • video_inspect, video_frames_create, video_trim, audio_detach, video_filter, timeline_create / timeline_audio / timeline_compose

It does not list crawl, Avatar, social or posting tools.

With an API key

An API key on https://api.sume.com/mcp gets every tool above. It also gets music_create, tts_create, stt_create, the Avatar tools (avatars_*, avatar_videos_*, avatar_video_previews_*), the asset tools (assets_*), web crawl (crawl_scrape, crawl_map, crawl_search, crawl_site, crawl_get), catalog_list, image_models_list / video_router_models, generation_admission_preview, script_run, tools_list, tools_schema and mcp_health.

REST-only (not on hosted MCP): Sume Image 1.0 and Video 1.0 (images_create / videos_create). Use the Developer API for those two products.

The tool list that your client shows is the source of truth for what a connection can call. On a sign-in connection, an API-key tool answers tool_not_found. API keys also get tools_list and tools_schema, which describe the tools of that key.

Next pages

  1. Quickstart — connect Cursor or Claude in a few minutes.
  2. Tools and gates — tool inventory, safety flags, and playbooks.
  3. Sign-in and API keys — auth matrix and mcp:read / mcp:write.
  4. Agents · Safe automation — how agents must treat API / CLI / MCP boundaries.

On this page

  1. Production endpoint
  2. Choose the right surface
  3. Auth at a glance
  4. What hosted MCP can do today
  5. On a sign-in connection
  6. With an API key
  7. Next pages