Sume tool missing in Claude Code: org block or read-only scope?
Claude Code's /mcp list now flags tools your organization blocked. A Sume tool can also be absent because the OAuth session has only mcp:read. How to tell.

A Sume tool can be missing from Claude Code for two different reasons, and the 2.1.283 /mcp list now separates one of them. Tools your organization blocked appear with a warning icon. A tool hidden because the OAuth session has only mcp:read does not appear at all, because Sume does not list mutating or paid tools to a read-only session.
The warning icon is from the Claude Code changelog entry dated September 25, 2026, read 2026-10-01. The scope behavior is from Sume's OAuth and API keys page.
What does the warning icon mean?
The changelog says the /mcp tool list shows more tools at once, scrolls with the page keys and mouse, and marks tools your organization blocked with a warning icon. The block comes from your organization's policy in Claude Code, not from Sume. If you see the icon, ask whoever manages your Claude Code settings.
Why would a Sume tool not be listed at all?
Under OAuth, the default grant is mcp:read. Per the docs, a read-only session sees read-only tools, and generate_image, generate_video or avatars_create appear only when Write was turned on at consent, or when you use an API key. Sume also leaves two legacy caption tools out of tools_list, though they stay callable by name.
| What you see | Cause | Fix |
|---|---|---|
| Listed with a warning icon | Your organization blocked it | Ask your Claude Code admin |
| Not listed; reads are listed | Session has mcp:read only | Sign in again with Write on, or use an API key |
| Name works only if typed | Tool is unlisted for new clients | Use the replacement tool from tools_list |
How do I check what Sume exposes to my session?
Ask the agent to call tools_list, which lists every tool visible to the current session with safety metadata, and tools_schema with a name for one tool's contract. catalog_list is broader: it lists public API capabilities, some of which have no MCP tool. The tools and gates page covers all three.
How do I get write tools without an API key?
Run the sign-in again and turn the Write toggle on at the consent page on the MCP host; there is no mcp:paid scope, so Write is the only extra grant. Claude Code then lists the mutating and paid tools. Keep idempotency_key on every paid submit.
Sources
Related posts
More in Integrations
- Claude Code MCP server shows connected but tools fail after a 404
Claude Code 2.1.283 fixed a brief 404 from a stateless remote MCP server leaving it unusable while shown connected. What to do for Sume's endpoint.
- Switch Opus 5.5 and Sonnet 5.5 mid-session: Sume jobs keep running
Claude Code 2.1.287 fixed /model and opusplan switches rewriting earlier MCP tool announcements. Sume jobs live on the server, so a new model can pick them up.
- Claude Managed Agents vault static_bearer for Sume tools
For Sume's hosted MCP in a Claude Managed Agents vault, use a static_bearer credential keyed to https://mcp.sume.com/mcp; OAuth tokens last an hour.
- Sonnet 5.5 and a 10-minute render: about 12 jobs_wait calls
A Sume job that takes ten minutes needs roughly 11 to 12 jobs_wait calls at the 55 and 50 second slices. How to keep a Sonnet 5.5 tool loop that short.
Written by Sume