Does Sume hosted MCP match the HTTP API? Where parity stops
Not fully. Hosted MCP covers most generation families, but Image 1.0 and Video 1.0 are REST-only, and schedules have no MCP tool. Use the HTTP API for those.
Not fully. Sume's overview says hosted MCP does not have full parity with the HTTP API. It covers account, catalog, jobs, assets, most generation families, crawl and Avatar tools. A few things need the Developer API instead: Sume Image 1.0 and Video 1.0 are REST-only, and schedules have no MCP tool, no CLI command and no create or edit endpoint.
What is where
The first rows are from the MCP overview, and the schedule row from the Scheduled page. catalog_list can show HTTP capabilities that have no MCP tool, so it is a good first look at the gap.
| Capability | On hosted MCP? | Where to go |
|---|---|---|
| generate_image and generate_video, with sume/auto routing | Yes | Hosted MCP |
| music_create, tts_create, stt_create | Yes | Hosted MCP |
| Sume Image 1.0 and Video 1.0 (images_create, videos_create) | No, REST-only | Developer API |
| Schedule runs (/v1/actions) | No MCP tool | Developer API to list and run; dashboard to create |
| Agent Completions (/v1/agent/completions) | No MCP tool | Developer API with a key that has the right scopes |
| Capabilities with no MCP tool | Shown by catalog_list | Developer API |
How to choose
Start with hosted MCP when an interactive agent should call Sume, because OAuth fits a client such as Cursor or Claude. Use the HTTP API for backends, scripts and the REST-only products. For Agent Completions, the docs say your own backend starts the run with an API key, which fits a server, not a chat client.
The tool you want not being in tools_list does not mean you lack permission. It may simply be a REST-only product or a read-only session. Check the scope first, then the overview.
- Missing write tools: check the session scope.
- Missing a whole product: check the REST-only list.
- Missing a schedule tool: there is none; use the dashboard or ask the Agent in chat.
The tradeoff
A split surface means an agent that needs both has to hold two kinds of access, MCP for interactive work and a key for the API. That adds setup, but it keeps the unattended, billing-heavy REST products away from a chat client that a person is steering.
If you are not sure where a feature lives, ask the agent to call catalog_list and tools_list and compare the two. Anything in the first and not the second is an HTTP capability or a scope question, and the overview page tells you which. That check is free, because both are reads, and it saves a failed paid call.
Sources
Related posts
More in Developers
- How long can an AI video Format run take? 90-minute limit
A Sume Format run expires 90 minutes after creation, sooner if silent. How to poll with backoff, when to use a webhook, and what expired means.
- How many 30-second videos can a Sume Pro key run at once? Wave math
Pro runs 4 generations at once and queues 20 more, so 24 accepted jobs. Use the plan table and a Python function to plan a 50-clip batch in waves.
- How many cuts fit in a 3-minute Short? Timeline caps slots at 200
A 180-second Short built with Sume Timeline can have at most 200 video slots, each at least 0.2 seconds. That averages 0.9 seconds a cut. Here is the math.
- How many images can I get per AI image request? Read n, don't guess
Sume's docs allow n up to 10 per call but say per-model ceilings are lower. Here is how to read each model's real n range from the catalog in one request.
Written by Sume