Claude Code 2.1.285 MCP_DISCOVERY_CACHE and Sume tools_list
Claude Code 2.1.285 can reuse connector tool lists after a cloud session restarts. What that means when your Sume tool surface changes between runs.

Claude Code 2.1.285, released September 29, can skip rediscovering a connector's tools after a cloud session restarts. The changelog says that MCP_DISCOVERY_CACHE=1, when set in a cloud environment's variables rather than a settings file, reuses connectors' tool lists across the restart (read 2026-10-04). For Sume's hosted MCP server at https://mcp.sume.com/mcp, that is a speed gain with one thing to watch: the cached list can lag the credential you hold now.
The changelog entry is short, so this post sticks to what follows from it and from Sume's own docs.
Why could a cached list be wrong for Sume?
What tools_list returns depends on the credential. Sume's tools and gates page says an OAuth token with only mcp:read sees read-only tools, while a token with mcp:write, or an API key, sees the full set. If you restart a cloud session with a different credential, a reused list can describe a surface the new credential does not have.
| Credential | Tools visible |
|---|---|
OAuth, mcp:read | Read-only tools |
OAuth, mcp:read + mcp:write | Full hosted set |
| API key | Full hosted set |
How do I check after a restart?
The read-only discovery tools in the quickstart are the ground truth.
- Call
mcp_healthfirst; it reports the auth source and safety posture the server sees now. - Call
tools_listand compare against what the agent believes it has. - If a write call returns
insufficient_scope, the credential lacksmcp:writewhatever the cache says. - Pass
idempotency_keyon every write and paid call, so a retry after confusion cannot charge twice.
Should I turn the cache on?
For long-running cloud jobs that always use the same credential, yes: it removes a round trip at every restart. For anything that changes scopes between runs, leave it off or rerun mcp_health as the first step of each session.
Sources
Related posts
More in Integrations
- Claude Code 2.1.288 background command limits: poll Sume jobs
Claude Code 2.1.288 applies the background command limit only to unattended sessions (-p, SDK, CI, cloud). How to poll a Sume job so a -p run keeps it.
- Sonnet 5.5 is Claude Code default with 1M context: trim Sume tools
Claude Code 2.1.284 made Sonnet 5.5 the default Sonnet with a 1M context window. A big window is not a reason to load every Sume tool schema.
- Claude MCP connector: allowlist read-only Sume tools by toolset
With the Messages API MCP connector an API-key Sume session exposes paid tools. Use an mcp_toolset with default_config enabled false and enable only job reads.
- Opus 5.5 computer toolset rejects strict: Sume tools do not need it
Anthropic's computer and browser toolsets reject strict mode. Sume media work runs through MCP tools and API calls, so a Claude agent needs neither toolset.
Written by Sume