Claude Code v2.1.259 · 2 Sep 2026
Headless SDK sessions expose a bindable $.tool.register API for MCP servers
Headless SDK sessions expose a session object for MCP servers with addMcpServer , removeMcpServer , toast, status and refreshContext .
Use it now Tier: how much it should matter to you
5 Useful: my rating, 1 to 5
3 Signal: worth watching, 1 to 5
SDK Area: what it touches
New Features Kind: in v2.1.259, 02 Sep 26
What probably matters to you Section of the release
Headless SDK sessions now expose a $.tool.register-style session object with addMcpServer , removeMcpServer , toast , status , and refreshContext hooks for MCP servers. In a headless session, calls to toast and status are logged rather than displayed, since there is no notification bar or status row to show them in.
What the documentation says
Since it was published
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
How sure we are
One source agrees One thing we can check says the same as this entry.
Anthropic's documentation agrees Anthropic's documentation has since written up addMcpServer, on permission-policies.
See this entry in the whole of v2.1.259 →
2 Sep 2026 · 195 entries, this one is #21.
Use it now22 You'll notice89 Nothing to try yet24 Under the hood60
Open the release →
Names in this entry
setting addMcpServer Headless SDK sessions expose a session object for MCP servers with addMcpServer, removeMcpServer, toast, status and refreshContext.
setting removeMcpServer Headless SDK sessions expose a session object for MCP servers with addMcpServer, removeMcpServer, toast, status and refreshContext.
setting refreshContext Headless SDK sessions expose a session object for MCP servers with addMcpServer, removeMcpServer, toast, status and refreshContext.
setting toast Plugins can install code that intercepts tool calls and repaints parts of the terminal interface.
setting status Plugin syncing fails fast on a forbidden response and tells you the HTTP status.
Is this right?
0
0
Feedback
What's wrong with this entry?
Hard to understand Too vague Looks wrong Not relevant to me Too long Missing the detail I wanted Duplicate of another card
Clear Learned something new I can act on this Good catch
Related
Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.
← Previous · 20 of 195
CLAUDE_CODE_SKILL_ATTRIBUTION test/override env var
Use it now Telemetry
In v2.1.259 What probably matters to you release-page order
Next → · 22 of 195
Managed settings can now supply MCP servers directly ("managed" as a first-class MCP…
Use it now MCP