Image 1.0 and Video 1.0 are not on Sume's hosted MCP: what to call
images_create and videos_create are REST-only. On hosted MCP the router tools generate_image and generate_video cover stills and clips. Fallback and checks.

If your agent looks for images_create or videos_create on https://mcp.sume.com/mcp, it will not find them. Sume Image 1.0 and Video 1.0 stay REST-only, so use the Developer API for them. On hosted MCP, router stills and clips are generate_image and generate_video.
| Capability | Hosted MCP | Developer API |
|---|---|---|
Image 1.0 (images_create) | Not listed | Yes |
Video 1.0 (videos_create) | Not listed | Yes |
| Router stills | generate_image | Yes |
| Router clips | generate_video | Yes |
Do not assume parity
The docs say hosted MCP tools wrap selected API capabilities and to rely on tools_list and tools_schema for the live contract. catalog_list may show HTTP capabilities with no MCP tool. Retired aliases map to the router tools: image-generations_create to generate_image, and video-router_create to generate_video.
How to check
Have the agent run the discovery tools before planning. This avoids a plan built around a tool that is not there.
- Call
tools_listand look for the name. - Call
tools_schemawithname: "generate_image"to see its contract. - Omit
payload.modelto route tosume/auto, unless the user named a family. - Add
dry_run: truebefore a paid call, then submit with anidempotency_key.
When you do need Image 1.0 or Video 1.0
Call the Developer API from a script with an API key, and let the agent hand off the result by public id. Keep jobs per member in mind: for API keys, job visibility is per member, so a job created by one key's member may not be visible to another's session.
Prompting an agent correctly
Add one line to the agent's instructions: use only tools that tools_list shows, and never invent a tool name from the REST docs. Agents that read the Developer API pages may try images_create over MCP, get an unknown-tool error, and then loop. Naming the router tools in the instructions avoids that.
Higgsfield-style names
The docs also list names that do not exist on Sume's hosted MCP, such as workflow-instruction and model-explore tools from other products. Cutouts use rmbg_create, and social URL mirroring uses media-imports_create. If a prompt written for another MCP server mentions a tool you do not see, check the Sume inventory before assuming it is broken.
If you need to mix both worlds, run the REST calls from a script or workflow step that holds an API key, and let the MCP agent handle everything else. The agent can then read the resulting jobs through MCP by id, as long as it uses the same workspace; remember that for API keys, job visibility is per member. Plan this split early, since moving a flow between the two surfaces later means changing its auth as well.
Before you rely on this setup, run a short acceptance test with a read-only credential. Connect, call mcp_health, call tools_list, and read one job with jobs_status. Record the tool count you see, so you can notice later if a credential change alters it. Then repeat the test after any config edit. A five-minute test like this catches most wiring mistakes before they cost money, and it gives you a baseline to compare against when something behaves differently next week.
Sources
More in Integrations
- Sume MCP insufficient_scope: why it happens and the two ways to fix it
A Sume MCP tool returns insufficient_scope when an OAuth session has mcp:read only. Fix it by re-consenting with Write on, or by using an API key.
- Sume MCP jobs_wait returns 524: it is not a failed job
A 524, 522, 523 or 525 on Sume jobs_wait is a transport failure, not a job result. Wait again on the same ids and never resubmit the paid create.
- Sume MCP jobs_wait with 20 job_ids: wait_for any versus all
jobs_wait takes up to 20 job_ids and wait_for any or all. All is the default. Any returns early, but the other jobs keep running and billing. Examples inside.
- Sume MCP with Write off: what an OAuth agent can still do
With OAuth read-only (mcp:read), an agent on Sume's hosted MCP can still read jobs, assets and the catalog and scrape pages. Writes and paid tools fail.
Written by Sume