Integrations
Calling Sume from automation platforms, serverless functions, agent frameworks, and MCP clients. Each uses plain HTTPS or remote MCP, not a connector.
Intercom outbound message with a Sume avatar clip: email or in-app
Intercom's create-message API sends in_app, email or whatsapp with an HTML or plain body. It documents no video field, so link a Sume clip. How to set it up.
Viber bot video message: 26 MB, 180 s, .mp4 URL, a Sume clip
Viber's bot API wants an MP4 URL ending in .mp4, 26 MB max, 180 s max, and a JPEG thumbnail. A 60 second Sume avatar clip fits. The checks to run first.
Braze Connected Content has 2 seconds: pre-render the Sume clip
Braze drops Connected Content that answers in over 2 s. A Sume avatar job takes longer, so render first, store the URL, and let the campaign read a fast lookup.
Braze 404 renders empty: a fallback while the Sume clip renders
Braze turns a 404 into an empty string. Sume returns 409 job_not_completed until a result exists. Map one to a fallback URL so no message goes out blank.
Render a Short over MCP: timeline_create, jobs_wait, timeline_get
Three hosted MCP tool calls turn a Timeline document into a vertical Short: create with an idempotency_key, wait on the job, then fetch the result.
Cloudflare Worker: keep the image model id in KV and swap it live
A Worker that proxies POST /v1/images and reads the Sume model id from Workers KV, so replacing gpt-image-1 is a wrangler command, not a deploy.
GitHub Actions repository variable for the image model id: no commit
Keep the Sume image model id in a GitHub Actions repository variable, so a gpt-image-1 replacement is a settings change or one gh command, not a pull request.
provider.only on Sume image requests: why other slugs return 400
Porting an OpenRouter-style image call? On Sume, provider.only and order accept only sume; other slugs return 400 provider_not_available. Field rules.
Claude Code MCP_TOOL_TIMEOUT is about 28 hours; Sume waits 55 s
Claude Code lets a tool call run for about 28 hours by default, but Sume's hosted jobs_wait caps one call at 55 seconds. Why you still loop in short slices.
Claude Code saves MCP text over 50,000 characters: size Sume reads
Claude Code writes long MCP text results to a file, and Sume caps a tool answer at 256 KiB. Read job waves in batches of 20 ids so each answer stays small.
Codex startup_timeout_sec 10 and tool_timeout_sec 60 for Sume
Codex defaults to a 10 s startup and a 60 s tool timeout per MCP server. Sume's jobs_wait holds at most 55 s, so the tool default only just fits.
Cursor MCP auth block with CLIENT_ID and CLIENT_SECRET: skip for Sume
Cursor's mcp.json supports an auth block with CLIENT_ID and CLIENT_SECRET for servers that need a fixed client. Sume's hosted OAuth does not; use just the URL.
Gemini CLI httpUrl or url for Sume: streaming HTTP versus SSE
In Gemini CLI, httpUrl is for streaming HTTP and url is for SSE. Sume's hosted endpoint is a streamable HTTP server, so use httpUrl with the production URL.
Gemini CLI trust: true removes the prompt; what guards Sume spend
With trust: true, Gemini CLI stops confirming a server's tool calls. For Sume the guards left are idempotency_key, wallet admission and your max_spend_usd.
Is mcp.dev.sume.com a staging URL I can use? No, use mcp.sume.com
mcp.dev.sume.com is for Sume's own development environments. Customer configs should use https://mcp.sume.com/mcp, and OAuth tokens are bound to that resource.
Can I swap a Sume MCP OAuth token for an API key? Why you should not
A hosted MCP OAuth token is not a Sume API key. Do not mint keys as a workaround for a read-only session; turn Write on at consent, or use a key on purpose.
Zed tool permissions: confirm by default, rules per Sume tool
Zed confirms every tool action by default and can allow or deny one MCP tool by name. Keep Sume's paid generators on confirm while reads run freely.
Haystack MCPTool with StreamableHttpServerInfo and Sume MCP
Connect Haystack to Sume's hosted MCP with MCPTool and StreamableHttpServerInfo: a url, an Authorization header, one tool per MCPTool, and what to call first.
VoltAgent MCPConfiguration: connect to the Sume hosted MCP server
VoltAgent's MCPConfiguration takes type http, a url and requestInit headers. Reach Sume at mcp.sume.com/mcp with an API key, then pass tools to an agent.
Manus Custom MCP Servers: add Sume under Settings > Integrations
In Manus, open Settings > Integrations > Custom MCP Servers > Add Server and enter Sume's HTTPS endpoint and credentials. Manus verifies by fetching tools.
v0 custom MCP: connect Sume with a Bearer token or OAuth
In v0, open the + menu, choose MCPs, add a custom MCP and pick Bearer Token or OAuth for auth. Which to use for Sume's hosted server, and what each grants.
DSPy Tool.from_mcp_tool with Sume hosted MCP: async notes
dspy.Tool.from_mcp_tool wraps a tool from a live MCP session. What changes with Sume's hosted server: async calls, error results and paid-tool gates.
Trae IDE: add Sume as a remote MCP server with Add Manually
In Trae, open Settings > MCP > Add > Add Manually and paste a JSON entry with Sume's hosted URL and an Authorization header. Steps, trade-offs, key handling.
Cherry Studio: add Sume as a remote MCP server and bind it
In Cherry Studio, add a server under Settings > MCP, enable it, check its tools, then bind it to an Agent. A server that is not started cannot be bound.
One 1080x1920 master for Meta, TikTok, Pinterest and Shopify limits
One vertical MP4 can pass four platforms: Instagram Feed 1080x1920, TikTok 540x960 minimum, Pinterest 2 GB and 6-15 s, Shopify 1 GB. Limits read 2026-10-05.
MCP unsupported_payload_keys: read the allowed array
A key a Sume MCP tool does not list returns unsupported_payload_keys with unexpected, allowed, tool and sometimes path. Fix it from the allowed list.
MCP unsupported arguments: move the field into payload
A Sume MCP call with quality beside payload fails with unsupported_tool_arguments. Read hint move_to_payload and the adjustments array, then retry once.
avatar-image-to-video_create: audio_url and duration_seconds
avatar-image-to-video_create needs a Sume-hosted audio_url and duration_seconds (1 to 300) matching the audio. Missing either gives missing_payload_field.
MCP conflicting_payload_fields: image_url or avatar_id, not both
Sume's avatar-image-to-video_create and kling-motion-control_create take image_url XOR avatar_id or avatar_handle. Both returns conflicting_payload_fields.
kling-motion-control_create: motion_video_url, 1 to 30 s, no model
kling-motion-control_create needs a public HTTPS motion_video_url and duration_seconds of 1 to 30, and refuses a model field with provider_fields_not_accepted.
MCP wrong_tool from generate_video: lip sync and motion control
Sume's generate_video refuses minimax/h3-max/lip-sync and the Kling 3.0 motion-control model with wrong_tool. next_action names the tool to call instead.
MCP max_spend_exceeded: how Sume compares a dry run to your cap
max_spend_usd is optional on Sume's paid MCP tools, from 0 to 10,000. If the estimate is higher, max_spend_exceeded stops the call before it bills.
Apple Shortcuts: generate a Sume image with Get Contents of URL
Build a Shortcut that POSTs JSON to Sume's /v1/images and shows the result: Get Contents of URL, a JSON body, a bearer header, and a check for the 202 case.
Google Sheets =IMAGE() with a Sume URL: PNG, JPEG, never SVG
=IMAGE needs a URL with a protocol and rejects SVG and drive.google.com links. Put a Sume data[0].url from a png or jpeg request in a cell and pick a mode.
Google Slides createImage with a Sume URL: use PNG or JPEG
CreateImageRequest takes PNG, JPEG or GIF, up to 50 MB and 25 megapixels, from a public URL of 2 KB or less. Ask Sume for output_format png or jpeg, not WebP.
MCP jobs_wait wait_deadline_exceeded vs wait_canceled: what to do
Both are retryable 503 results from Sume's jobs_wait with next_action poll_status. The job is untouched: call jobs_wait again, never resubmit.
MCP missing_tool_argument vs invalid_tool_argument: three look-alikes
Sume's MCP server has three near-identical codes: missing_tool_argument, invalid_tool_argument and invalid_tool_arguments. Learn which field each one names.
MCP 503 mcp_oauth_unavailable vs 401: do not re-sign-in
A bad OAuth token gets 401 with WWW-Authenticate; a server fault gets 503 mcp_oauth_unavailable or mcp_oauth_not_configured. Retry on 503, sign in only on 401.
Notion API image block with a Sume URL: PNG works, WebP is not listed
Notion's external image block needs a directly hosted, public URL, and its file-type list has no WebP. Ask Sume for png or jpeg, then append the block.
Obsidian plugin: call Sume with requestUrl and embed the image
Obsidian's requestUrl skips CORS limits, so a plugin can POST to Sume's /v1/images. Save the file with createBinary and insert an embed. Handle the 202 case.
Slack image block with a Sume URL: PNG or JPEG, alt text required
Slack's image block takes a public image_url up to 3000 characters and lists png, jpg, jpeg and gif. Generate a png with Sume, then post it with alt_text.
Which video models can my agent call? video-router_models
Sume's MCP server has video-router_models to list video ids, limits and prices, and generate_video to create clips. How an agent should use them, in order.
No generate_video tool for Sume in ChatGPT or Claude: Write is off
A Sume OAuth session with only mcp:read hides write and paid tools like generate_video. Reconnect with Write on, or use an API key; confirm in tools_list.
Read-only MCP session lists avatars; create gives insufficient_scope
A hosted MCP connection with read scope can list and search avatars, but paid avatar and video tools return insufficient_scope until you grant write.
Upload a local file to Sume from chat: hosted MCP can't read disk
Hosted Sume MCP cannot read your laptop files. The flow is assets_upload_url, a client PUT of the bytes, then assets_complete. What to do in ChatGPT or Claude.
Veo videos vanish after 2 days: copy to Cloud Storage and expire them
Google keeps Veo output on its server for 2 days. Copy each clip to your own bucket, then let a Cloud Storage lifecycle rule delete old copies on a schedule.
Claude API MCP connector: public server, tool calls only, one toolset
The Claude API MCP connector reaches only public HTTP servers and supports only tool calls. mcp.sume.com fits. Here are the request, beta header and limits.
Pub/Sub push ack codes and a Sume webhook relay with a signature check
Pub/Sub treats only 102, 200, 201, 202 and 204 as acks. Verify Sume's sume-v1 signature at the edge, publish, return 2xx, and let Pub/Sub retry the workers.