MCP overview
Sume exposes a hosted Model Context Protocol (MCP) endpoint so agents can call Sume account, catalog, job, asset, and Avatar tools without wrapping the HTTP API yourself.
Production endpoint
Use that URL in Cursor, Claude Code, Codex, and other remote MCP clients.
Internal/dev note: https://mcp.dev.sume.com/mcp exists for Sume development
environments. Public docs and customer configs should use mcp.sume.com.
Choose the right surface
| Surface | What it is | When to use |
|---|---|---|
| Hosted MCP | Remote HTTP MCP at https://mcp.sume.com/mcp | Connect Cursor/Claude/Codex to Sume over OAuth or an API key. Preferred MCP path today. |
Local sume mcp | CLI MCP command (stdio client setup) | Not launched in current sumelabs/cli releases (sume mcp doctor → coming_soon). Use hosted MCP or direct CLI commands instead. |
| Developer API / CLI | https://api.sume.com/v1 and sume binary | Backend integrations, scripts, Avatar CLI submits, and Image/Video/Music HTTP submits. |
| Studio Agent | Product agent experience in the Sume app | In-product agent workflows. Not a public MCP connector, and not documented here. |
Hosted MCP is the supported remote connector today. Local sume mcp remains a
future CLI surface — do not document or configure it as a working stdio server
yet. Neither is the Studio Agent product surface. See also the
CLI overview.
Auth at a glance
| Auth | Hosted MCP capability today |
|---|---|
| OAuth (Phase 1) | Read-only tools. Scope is mcp:read. Write and paid tools return insufficient_scope. |
| API key | Full hosted tool set, still gated by allow_write / allow_paid / dry_run. |
OAuth is the preferred path for interactive clients like Cursor and Claude. API-key remote MCP remains available for existing automation.
Details: OAuth and API keys.
What hosted MCP can do today
Hosted MCP is not full parity with the HTTP API.
Shipped paid generation tools are Avatar-focused:
avatars.createavatar-videos.create
There are no hosted MCP tools today for Image, Video, Music, STT, or Video Router generation. Use the Developer API for those families.
Discovery tools such as catalog.list, tools.list, and tools.schema tell
the client exactly which MCP tools are available in the current session.
Next pages
- Quickstart — connect Cursor or Claude in a few minutes.
- Tools and gates — tool inventory, safety flags, and playbooks.
- OAuth and API keys — auth matrix and Phase-1 OAuth limits.
- Agents · Safe automation — how agents should treat API / CLI / MCP boundaries.