Sume MCP with an API key versus OAuth: which tools your AI client sees
Why Claude, Cursor, Codex or Copilot may show fewer Sume tools: OAuth is read-only until consent includes write; an API key shows all.
If a client lists fewer Sume tools than you expected, check how it authenticated. An OAuth session starts read-only (mcp:read) and gains write tools only if the user turned on mcp:write at consent. An API key sent as Authorization: Bearer or x-api-key returns the full tool set and spends against that key's workspace.
Start diagnosis with the discovery tools: mcp_health, tools_list, tools_schema, catalog_list, account_me and generation_admission_preview.
Symptoms and fixes
| Symptom | Likely cause | Fix |
|---|---|---|
| Paid tools missing | OAuth without mcp:write | Re-consent with Write on |
| insufficient_scope on generate | Read-only OAuth session | Re-consent with Write on, or use a key |
| Tool list differs between clients | Different credentials | Compare account_me output |
| Image 1.0 or Video 1.0 not listed | REST-only | Call images_create or videos_create over REST |
Preview before paying
generation_admission_preview and dry_run let a client check admission and cost without submitting, and max_spend_usd caps a call when sent. They are arguments the model writes, so they are guidance, not a limit your client enforces.
Sources
Related posts
More in Integrations
- Wix Stores product video: 50 MB limit and an AI clip
Wix Stores takes AVI, MP4, MOV or MPEG product video up to 50 MB. Measure a Sume clip, then shorten it, drop audio or conform its size with video trim.
- How to add an MCP server to ChatGPT with developer mode
Turn on ChatGPT developer mode, create an app for the server's URL, and sign in with OAuth. The steps, with Sume's hosted MCP server as the example.
- How to add subtitles to a video in Python
Add subtitles to a video in Python with Requests: POST the video URL to Sume's /v1/video-captions, poll the job, then read the captioned video_url.
- Add Sume to Claude as a custom connector (remote MCP)
Add Sume's hosted MCP server to Claude under Customize > Connectors, see what Sume's OAuth consent grants, and decide whether to allow paid tools.
Written by Sume