Integrations
Calling Sume from automation platforms, serverless functions, agent frameworks, and MCP clients. Each uses plain HTTPS or remote MCP, not a connector.
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.
Zapier MCP costs two tasks a call: batch Sume jobs_wait first
Each Zapier MCP tool call uses two tasks. When an agent uses Sume and Zapier together, wait on all jobs in one jobs_wait, then make one Zapier call.
Claude Code headersHelper for a Sume API key: rotate with no edits
Claude Code can run a script for MCP headers on every connection. Use it to feed a Sume API key from a secrets store, so rotation needs no config edit.
Claude Code 25,000-token MCP output cap and Sume batch jobs_result
Claude Code truncates MCP output past 25,000 tokens by default. Sume include_results and batch jobs_result keep wave answers small. Settings and loop.
Claude Code MCP_TOOL_TIMEOUT and the timeout field for Sume jobs_wait
Claude Code has no short default tool timeout, so a stalled Sume jobs_wait can hang. Set a per-server timeout in .mcp.json and let the agent retry slices.
Gemini CLI httpUrl or url for Sume MCP: which key to use
In Gemini CLI settings, url is the SSE endpoint and httpUrl is HTTP streaming. Sume's endpoint is streamable HTTP, so use httpUrl. Config and checks inside.
Gemini CLI includeTools for Sume MCP: expose reads, keep trust false
Gemini CLI can allowlist MCP tools with includeTools, and trust defaults to false. Use both to give an agent Sume reads without paid generation.
Gemini CLI MCP timeout is 600000 ms; Sume jobs_wait caps at 55 s
Gemini CLI waits up to 10 minutes per MCP request, but Sume cuts jobs_wait at 55 seconds. Set the client timeout low and loop on wait_slice_expired.
Roo Code alwaysAllow for Sume MCP: which tools to auto-approve
Roo Code alwaysAllow skips the approval click. Auto-approve Sume read tools only, and keep paid ones manual or behind dry_run and a spend cap.
Roo Code MCP timeout 60 s default: add Sume as streamable-http
Roo Code defaults MCP requests to 60 seconds and allows 1 to 3600. Here is the streamable-http entry for Sume with a timeout that fits jobs_wait.
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 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 429 queue_full from an MCP agent: wave sizes for Free to Scale
An agent that submits too many paid jobs hits 429 queue_full. Accepted capacity is 6 on Free, 24 on Pro, 48 on Startup, 120 on Scale. Wave sizes inside.
Sume MCP script_run: fan out 3+ calls in one turn, 55 s limit
script_run runs a short JavaScript program on Sume that calls tools in a loop or in parallel. timeout_seconds is 5 to 55. Use it for 3+ similar calls.
Cut out 25 product photos from an agent: rmbg_create and jobs_wait
An MCP agent submits 25 rmbg_create calls, waits with jobs_wait in two slices (20 ids, then 5), and pays 25 x $0.0225 = $0.5625. Idempotency keys inside.
Photo dance via hosted MCP: kling-motion-control_create needs a key
The hosted MCP exposes kling-motion-control_create as a paid tool that requires an idempotency_key. 8 s of motion control costs 8 x $0.1575 = $1.26.
Let an agent pick talking video, Fabric or H3 Max over MCP
Rules for an agent on hosted MCP: avatar-videos_create for scripts, avatar-image-to-video_create for audio, and dry_run plus max_spend_usd before any paid call.
GitHub Actions weekly Sume bulk queue that fails on counts.failed
A scheduled workflow that creates a Sume bulk queue, polls it through transient 429 and 503, and turns a completed queue with failed items into a red job.
Deno.cron weekly Sume video run with a per-day idempotency key
A Deno.cron job that starts one Sume Format run each Monday, keyed by UTC date so a double fire replays, skips overlap, and hands the result to a webhook.
BigQuery product table to Sume bulk queues and a queue map
Read active SKUs from BigQuery, cast columns to plain JSON types, create one Sume bulk queue per 100 rows, and stream queue id, index and SKU to a map table.
n8n 2.43.0: resume agents after waiting workflows, with Sume runs
n8n 2.43.0 (pre-release, Oct 6) resumes Preview agents after waiting workflows finish. Pair a long Sume run with one webhook, deduped on request_id.
Forward a finished Sume run to team chat with a signed webhook
A standard-library Python receiver that verifies the sume-v1 signature, rejects an empty secret, and forwards primary_output_url when a Format run ends.
Sume hosted MCP: API key or OAuth for an overnight agent job?
OAuth fits a person at a keyboard; an API key fits an unattended agent. How Sume hosted MCP treats each, plus the guardrails to set before you leave it running.
Plan in Claude Code over MCP, then hand the batch to bulk runs
Use Claude Code with Sume's hosted MCP to prototype one video and read costs, then run the real batch from your backend with Format bulk runs and a spend cap.
Video generation MCP connector: six questions before you connect
Before you let an agent spend money through any MCP connector, ask six questions. Here are Sume's hosted MCP answers on auth, scopes, idempotency and spend.
Voiceover plus a Lyria bed for a reel in one agent session over MCP
Ask an MCP client to run tts_create and music_create on Sume, then check the take with stt_create. Which tool does which job, and where the agent must wait.
Cline autoApprove for Sume: list only the read-only tools
Cline's remote MCP entry supports an autoApprove array. Put Sume's read tools in it and keep paid creates such as generate_image on manual approval.
Copilot 'MCP servers in Copilot' policy: admin checklist for Sume
For Copilot Business and Enterprise, an MCP servers in Copilot policy controls remote servers. What an admin checks before allowing Sume's hosted endpoint.
OpenClaw still lists sora-2 as a configured video provider: fix it
OpenClaw issue 158876: the bundled OpenAI video provider still defaults to sora-2, though /v1/videos returns 404. What to do now, and a Sume video call.
Approval gate before posting AI video: verify the Sume webhook
Hold every AI video for human review before it posts. A Node verifier for Sume's signed job webhooks that refuses an empty secret, plus the review steps.
Reels ad: use an existing post or upload a new video? Sume 9:16 file
Meta's Reels ads page offers native video, image ads and existing Reels posts. Which route fits an AI video from Sume, and what file to prepare for each.
LinkedIn video ad needs an uploaded file, not a link: use the Sume MP4
LinkedIn's video ad spec says to upload the file, not link YouTube or Vimeo. How to take the MP4 from a Sume job, check it, and upload it.
Claude Code 2.1.293 HTTP MCP leak fix and long Sume job sessions
Claude Code 2.1.293 fixed a leak where an HTTP MCP connection kept every request it sent. Upgrade before a long Sume session and use batch jobs_wait.
Claude Code MCP tool name over 128 characters: does Sume hit it?
Claude Code 2.1.292 leaves out an MCP tool whose name passes 128 characters and names it in an error. Sume's longest tool name is 36, so it never trips it.
Codex 0.161.0 /mcp login: sign in to Sume without leaving the session
Codex 0.161.0 added /mcp login <name> to sign in to an MCP server from a live terminal session. Sign in to Sume with read access first, then add write.
VS Code 1.141 shows discovered MCP servers: where is the Sume entry?
VS Code 1.141 (Oct 7, 2026) lists MCP servers found outside your mcp.json in the Customizations editor. Check there for Sume's URL and the credential it uses.
Claude Code 2.1.290 claude -p skips resources/list: Sume is tools-only
Claude Code 2.1.290 no longer holds the first claude -p turn for HTTP MCP servers to answer resources/list. Sume declares tools only, so nothing is lost.
Gemini 0.63.0 auth loop fix for headless keyring: Sume key from env
Gemini CLI 0.63.0 fixed an infinite auth loop from a headless keyring. In CI, keep Sume's key in an environment variable and one header, not a keyring.
fastmcp-remote: connect a stdio-only MCP host to Sume's hosted MCP
FastMCP 3.4.0 added fastmcp-remote, a bridge from stdio-only hosts to HTTP servers with OAuth for HTTPS. Point it at mcp.sume.com/mcp, verify with mcp_health.
MCP Skills extension (SEP-2640): what Sume's hosted MCP exposes
SEP-2640 serves Agent Skills as skill:// MCP resources. Sume's hosted MCP declares tools only, so skills/list is not a Sume surface; here is what to use.
Zed 1.23.2 optional MCP fields fix: read Sume's tools_schema anyway
Zed 1.23.2 fixed OpenAI model calls to MCP servers that treated optional fields as required. For Sume, tools_schema shows which fields are required.
Azure DevOps remote MCP is GA: run it beside Sume's hosted MCP
Azure DevOps remote MCP went GA in sprint 278 with Foundry and Copilot Studio support. Here is how to hold it and Sume's MCP with separate credentials.
GitHub Actions job that renders a 9:16 clip on Sume as an artifact
A workflow file that replaces a Sora render step: submit to Sume, poll with a deadline, and upload the mp4 as a build artifact. The key stays in a secret.
WhatsApp Business MCP is dev-only: keep Sume generation server-side
WhatsApp Business tools MCP was announced as dev and test only. Generate with Sume on your server and gate the MCP transport by environment. Tested code.
jobs_wait for 20 transcription jobs in one MCP call
The hosted MCP jobs_wait takes up to 20 job_ids, wait_for all or any, and include_results returns each finished transcript. Retry slices of 55 seconds.
jobs_wait outcomes: wait_slice_expired, operator_stopped, omitted
What each jobs_wait answer means on Sume's hosted MCP and what your agent should do next: call again, stop waiting on stopped ids, or read omitted results.
stt_create dry_run and max_spend_usd: cap an MCP transcription run
On Sume's hosted MCP, dry_run previews admission and cost without submitting, and max_spend_usd caps a paid stt_create. Add an idempotency_key to every write.
Braze retries a 500: keep the Sume job submit idempotent
Braze sends 500 and 502 responses to retry logic, and a :retry option exists. Give every Sume submit a stable Idempotency-Key so a retry is not a second bill.