Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.309 ·

MCP config files are tracked, and a host can hand over a ready-made tool listing

--mcp-config file paths are now recorded and registered, and an MCP config can carry a pre-supplied tool listing so discovery can be skipped

Group of 4 Use it now No documentation found New Features
JSON All of v2.1.309
Use it nowTier: how much it should matter to you
4Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
MCPArea: what it touches
New FeaturesKind: in v2.1.309,
What probably matters to youSection of the release

Unclear It is not clear what supplies handed_listing or whether this is switched on for ordinary local sessions.

What

MCP servers are outside programs that give Claude Code extra tools. --mcp-config is the option that loads them from JSON files or strings. Two related things changed in how this configuration is read:

  • File paths: the paths of files given to --mcp-config are now kept for the whole session (flagMcpConfigFilePaths, cleared on reset). For each one that is a file, both the path and its real location on disk are collected and passed to a new registration step, which checks them against the scan of allowed folders. Before, the file was read with no path registration.
  • Handed listings: a server's config can now include a handed_listing string next to its url. The parser returns these as handedListings, and startup passes them on as handedMcpListings. In headless mode, a listing (its startup handshake plus tools_list, with an at timestamp) is accepted only for a dynamic http server whose URL matches. A listing older than 600 seconds is dropped. When connecting, cached servers can now have their capabilities, server details and instructions filled from a stored handshake. What supplies this data and whether it is switched on was not traced.

Why

A program hosting Claude Code can hand over a server's tool list ahead of time, so Claude Code can skip asking the server for it, which affects how quickly tools are available at startup.

Read from
Names in the bundlehanded_listing
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is not clear what supplies handed_listing or whether this is switched on for ordinary local sessions.

See this entry in the whole of v2.1.309 →

Feedback