Generate images for a website with Claude Code and Sume MCP
Connect Claude Code to Sume's hosted MCP with Write access, preview the cost with dry_run, then generate site images and save them in your repo.
Agents
The Sume video agent from code: Agent Completions, scheduled runs, MCP tools and timeouts, programmatic tool calling, and guardrails for paid APIs.
Start with: What is a video agent? How Sume defines and runs one
Summarize a video with an API: transcript, stills, then JSON
Summarize a Sume-hosted video: pull stills and a transcript with POST /v1/video-inspect, then send both to Agent Completions with an output_schema.
What is Sume? A video agent platform, its API, and billing
Sume is a video agent platform: brief an agent in chat, save the recipe as a Format, and call it from your backend over one API. Surfaces and billing.
Sume Agent Completions vs Format vs Scheduled runs: request body diff
Sume Format runs, Scheduled runs, and Agent Completions share field names, not rules: spend-cap defaults, null, on_active_run, attachments, and scopes differ.
Prevent overlapping AI agent runs on Sume with on_active_run
Sume's on_active_run field decides what a second run request does while one is in flight: run anyway, record a skipped run, or get a 409 and nothing runs.
MCP vs CLI vs API for AI agents: which Sume interface to use
On Sume, HTTP and the Format API are the primary path for AI agents. Hosted MCP fits remote MCP clients; the CLI fits shell agents and is Avatar-heavy.
MCP tool call timeouts on long-running video jobs: use jobs_wait
On Sume's hosted MCP server, one jobs_wait call holds at most 55 seconds. Wait out long video jobs in slices, batch up to 20 ids, and never resubmit.
Sume MCP tools list: hosted tools grouped by read, write, and paid
The Sume MCP tools list by family: which hosted tools only read, which write, which start paid jobs, and which tool names are not on hosted MCP at all.
Programmatic tool calling on MCP: how Sume's script_run works
script_run is programmatic tool calling on Sume's hosted MCP: a short JavaScript program calls tools in loops or in parallel under call and paid budgets.
Video editing MCP server: let an AI agent trim, filter, and assemble
Sume's hosted MCP server gives AI agents video editing tools: inspect, frames, trim, filter, audio detach, compose, and a Timeline render, each run as a job.
List scheduled agent runs over the Sume API: audit your schedules
List Sume schedules with GET /v1/actions (limit, status, trigger_type), page each run history with a cursor, and read trigger.source to tell cron from API runs.
Agent API with image input and JSON output: Sume Agent Completions
Send images to Sume Agent Completions as input_image parts or attachments, bind an output_schema, and read typed JSON from output when the run completes.
What is a video agent? How Sume defines and runs one
In Sume's docs, a video agent is a sandbox Agent that composes generation tools into a post-ready video. Brief it in chat, or call it over HTTP.
Safe automation for AI agents that call paid APIs
Keep agents read-only by default, keep secrets out of logs, and on hosted MCP send an idempotency_key, preview with dry_run, and cap with max_spend_usd.
Scheduled AI video agent runs: cron, API triggers, and receipts
A Sume schedule is a saved Agents automation that runs on a cron cadence and returns a run receipt. Author it in the dashboard; start and monitor runs by API.
Run the Sume video agent from your backend with Agent Completions
POST /v1/agent/completions runs the same agent as the Sume Agents chat, with tools and media generation, and returns an async run receipt you poll or webhook.