---
title: Agents
description: How Sume developer tools fit into agent workflows.
---

Sume developer tools use one boundary: the public API is the source of truth,
and wrappers stay thin.

## Tooling layers

1. Developer API: workspace-scoped HTTP endpoints.
2. CLI: shell-friendly wrapper around the Developer API.
3. Hosted MCP: remote MCP at `https://mcp.sume.com/mcp` for Cursor, Claude, and
   similar clients.
4. Local `sume mcp`: future CLI surface (`coming_soon` in current releases) —
   use hosted MCP or direct CLI commands instead.
5. Dashboard tools: app-integrated tools with server-resolved workspace context.

Agents should use catalog, jobs, media schema, and usage reads for planning
before requesting confirmation for write or paid actions. See
[Safe automation](/agents/safe-automation).

## Where to start

| Goal | Start here |
|---|---|
| Call a saved authoring recipe from your backend | [Format API](/formats) · [Format catalog](/formats/catalog) |
| Interactive Cursor / Claude connector | [MCP quickstart](/mcp/quickstart) |
| Local shell agent with CLI | [Quick start](/) · [CLI overview](/cli) |
| Backend / server integration | [Quick start](/) (API) · [Public API](/public-api) |
| Run the Agent on an ad-hoc task from your backend | [Agent Completions](/agents/completions) |
| Run an agent on a recurring schedule | [Scheduled](/agents/actions) |
| Create an API key | [API Keys dashboard](https://www.sume.com/dashboard/api-keys) |
| Agents product UI | [Agents](https://www.sume.com/agents) |
| Avatar or Image first job | [Create new avatar](/models/avatar) · [Image 1.0](/models/image) |

Hosted MCP paid tools include `generate_image`, `generate_video`,
`music_create`, `tts_create`, and Avatar/Stage P creates. Sume Image 1.0 and
Video 1.0 (`images_create` / `videos_create`) stay REST-only — call the
Developer API for those two products. Details: [MCP overview](/mcp).

## Workspace context

Agent tools should not ask the user for a workspace id. Workspace context comes
from the API key or authenticated app session.