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: enable only Sume's read-only tools
Set the Claude MCP connector's default_config to disabled and enable named Sume tools. A read-only assistant list, plus the OAuth scope that backs it up.
- Claude MCP connector supports tool calls only; Sume MCP is tools-only
Claude's MCP connector uses only tool calls from the spec. Sume's hosted MCP also exposes only tools, so nothing is lost: what the server declares.
Written by Sume