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

Claude Code v2.1.304 ·

MCP tool search is tried behind custom endpoints and held off in conversations that ran without it

Tool search is now tried with a custom ANTHROPIC_BASE_URL and switched off for a day only if refused, and stays off in conversations that ran without it

Group of 2 You'll notice Improvements
JSON All of v2.1.304
You'll noticeTier: how much it should matter to you
3Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Tool SearchArea: what it touches
ImprovementsKind: in v2.1.304,
ImprovementsSection of the release

What

MCP tool search lets Claude look up extra tools when it needs them instead of loading them all at the start, through the ToolSearch tool. This release changes two situations where Claude Code turns it off by itself.

  • Custom API endpoints. ANTHROPIC_BASE_URL points Claude Code at a proxy or gateway instead of Anthropic's own servers. Before, tool search was switched off straight away when that address was not a first-party Anthropic host. Now the request is sent with tool search anyway. If the endpoint refuses it and answers without tool search, Claude Code stores the time of the refusal (toolSearchRefusedAt) for that endpoint and model, logs a warning, and keeps tool search off there for a day.
  • Conversations that ran without it. If a conversation has already run without ToolSearch, tool search now stays off for the rest of that conversation, until it is compacted (shortened into a summary) or cleared. A message says so, and the decision is recorded with the reason held_off.

The ENABLE_TOOL_SEARCH setting controls both:

  • ENABLE_TOOL_SEARCH=false skips the request that would be refused.
  • ENABLE_TOOL_SEARCH=true always sends tool search, turns off the one-day recovery, and overrides the hold-off in a conversation.

The stock ToolSearch description in v2.1.304 is 953 characters, from a capture taken under this release.

Why

If you use a proxy, you are no longer locked out of tool search just because of the address. You get it automatically when the proxy supports it, and after one refusal Claude Code stops trying for a day. Within one conversation the set of available tools now stays the same, which affects how deferred tools such as EndConversation load.

Read from
Names in the bundleANTHROPIC_BASE_URL
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.

Confirmed since Anthropic's documentation has since written up ANTHROPIC_BASE_URL, on Scale to many tools with tool search. > Tool search is on by default behind an `ANTHROPIC_BASE_URL` gateway, with nothing to set. If the gateway rejects it, see [Tool search through an LLM gateway](/docs/en/mcp#tool-search-through-a-gateway). Before Claude Code v2.1.304, the S… agent-sdk/tool-search see the edit
Added since A small documentation edit on Connect to external tools with MCP touched a line naming ANTHROPIC_BASE_URL after this was published. * **With [tool search](/docs/en/agent-sdk/tool-search), the default**: the wait covers still-pending servers configured with [`alwaysLoad: true`](/docs/en/mcp#exempt-a-server-from-deferral), and servers it leaves out keep connecting in the… agent-sdk/mcp see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesA small documentation edit on Connect to external tools with MCP touched a line naming ANTHROPIC_BASE_URL after this was published.
Anthropic's release notes agreeChanged tool search to be on by default behind a custom ANTHROPIC_BASE_URL; a 400 or 422 from the gateway is retried without it

See this entry in the whole of v2.1.304 →

Feedback