MCP quickstart

Sume has one MCP URL for all clients:

https://mcp.sume.com/mcp

Add the URL to your client. The client opens a browser. Sign in to Sume, then select Allow. You do not need an API key.

1. Connect your client

Claude (claude.ai and Claude Desktop)

Add Sume to Claude

The link opens Add custom connector in Claude with the name and the URL filled in. Select Continue and finish the steps. To add it by hand, open Customize → Connectors in Claude, add a custom connector, and paste the URL. On a Team or Enterprise plan, an owner adds custom connectors.

Claude Code

claude mcp add --transport http sume https://mcp.sume.com/mcp
claude mcp login sume

claude mcp login opens the browser. Sign in, then select Allow. In a session, /mcp shows sume as connected.

Cursor

Add Sume to Cursor

Or add Sume to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp"
    }
  }
}

Cursor shows Needs login next to sume. Select it, sign in, then select Allow.

Codex

codex mcp add sume --url https://mcp.sume.com/mcp
codex mcp login sume

ChatGPT

Sume is not in ChatGPT's plugin directory yet, so you add it as a custom MCP server. ChatGPT offers this on the web, not in the mobile apps. On ChatGPT Business, only workspace admins and owners can add one; on Enterprise and Edu, admins and members they allow. On a personal plan, ChatGPT decides which plans show the option.

1. In ChatGPT, open Plugins, select +, then Add custom MCP server.
2. Name it Sume and enter https://mcp.sume.com/mcp as the URL.
3. Set Authentication to OAuth, tick I understand and want to continue, then select Create as a plugin.
4. Sign in to Sume and select Allow.
5. In a chat, type @, pick Sume, and ask for an image or a video.

Other clients

Add the URL as a streamable HTTP MCP server. The client finds the sign-in at https://mcp.sume.com/.well-known/oauth-protected-resource/mcp. A script that cannot sign in sends a Sume API key to https://api.sume.com/mcp instead (Authorization: Bearer $SUME_API_KEY or x-api-key); https://mcp.sume.com/mcp does not take API keys. Refer to Sign-in and API keys.

2. Allow access

After you sign in, Sume shows which app asks for access and the account that you signed in with.

• Read is always on. The app can see your balance, models, workspaces and jobs.
• Create and spend credits lets the app make images, videos, and audio, upload files, and cancel jobs. Keep it on to generate. If you turn it off, the app can only read.
• If the page shows a Workspace choice, pick the workspace whose balance the app spends. If it does not, the app uses your personal workspace.

Select Allow to connect, or Deny to stop.

3. Make your first image

Ask the agent:

Use Sume to make an image of a red apple on a white table. Show me the link.

The agent calls two tools:

1. generate_image with payload.prompt and an idempotency_key. Sume answers in about a second with a job_id.
2. jobs_wait with that job_id and include_results: true. When the job is done, the answer has the image URL (https://media.sume.com/...). While timed_out comes back true, the agent calls jobs_wait again with wait_slice_expired.pending_job_ids.

In Claude, the image also shows up in Sume's viewer right in the chat. It waits for the job on its own. Select the image to see it full screen with the prompt, the model and the ratio. Download saves the file, and Animate, Edit and Recreate put a ready request into your message box, so the agent runs it with generate_video or generate_image once you send it.

Images take 10–60 seconds. Videos (generate_video) take 1–5 minutes. To see the price first, ask the agent to add dry_run: true. Sume then shows the price in dollars and does not run the job.

To use a file from your computer as a reference, the agent sends it to media_upload as file, then passes the https://media.sume.com/... URL that comes back. A client that can reach the upload URL can instead use the media_upload PUT flow and then media_confirm. A public https:// image or video URL works directly.

4. When something goes wrong

Local CLI alternative

If the agent can run shell commands on your machine, direct CLI commands also work (sume login, sume tools list --json, sume jobs …). Refer to the CLI overview. Local sume mcp is not launched in the current CLI releases (sume mcp doctor → coming_soon). It is separate from the hosted connector at mcp.sume.com.

Studio Agent is different

Studio Agent is the in-app Sume agent product. It is not the public hosted MCP connector that these pages document. Do not configure Studio Agent internals as a customer MCP server URL.