---
title: MCP overview
description: Hosted Sume MCP for Cursor, Claude, and other MCP clients.
---

Sume exposes a hosted [Model Context Protocol](https://modelcontextprotocol.io/)
(MCP) endpoint so agents can call Sume account, catalog, job, asset, and Avatar
tools without wrapping the HTTP API yourself.

## Production endpoint

```text
https://mcp.sume.com/mcp
```

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](/cli).

## 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](/mcp/oauth).

## What hosted MCP can do today

Hosted MCP is **not** full parity with the HTTP API.

Shipped paid generation tools are Avatar-focused:

- `avatars.create`
- `avatar-videos.create`

There are **no** hosted MCP tools today for Image, Video, Music, STT, or Video
Router generation. Use the [Developer API](/public-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

1. [Quickstart](/mcp/quickstart) — connect Cursor or Claude in a few minutes.
2. [Tools and gates](/mcp/tools-and-gates) — tool inventory, safety flags, and playbooks.
3. [OAuth and API keys](/mcp/oauth) — auth matrix and Phase-1 OAuth limits.
4. [Agents](/agents) · [Safe automation](/agents/safe-automation) — how agents
   should treat API / CLI / MCP boundaries.