Follow Discord
Sweep 12 Nov 2026 · 23:00Z Build v2.1.323 540 read Stable v2.1.311 Latest v2.1.323 Next v2.1.323 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

tool.list

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

Plugins can install code that intercepts tool calls and repaints parts of the terminal interface.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.242.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 162on this box, as of v2.1.323
Written about v2.1.242 first named in a changelog, 24 Aug 2026

In the changelogs

7

Releases whose published page names tool.list.

  1. v2.1.323
    Plugin hooks can now add and remove the tools Claude has in a session

    A new tool.list hook event lets a plugin's hooks module remove tools from a session or add new ones

    named in this entry, found in this entry's text

  2. v2.1.323
    Plugins can now react to MCP connections and change the tool list

    Plugins gain mcp.connect and tool.list hooks, so they can step in on MCP connections and add or remove tools in a session

    named in this entry, found in this entry's text

  3. v2.1.323
    Add-ons can now hook into the list of tools

    Add-on code can now respond to a tool.list event when Claude Code lists its tools

    named in this entry, found in this entry's text

  4. v2.1.323
    MCP tool calls are refused when a hook has removed the tool

    Before an MCP tool call runs, tool.list hooks are now consulted, and the call is refused if one of them removed the tool

    named in this entry, found in this entry's text

  5. v2.1.323
    The list of available tools can now be rebuilt when plugins signal a change

    Claude Code can now rebuild its list of available tools in response to a tool.list event, so the list can change during a session

    named in this entry, found in this entry's text

  6. v2.1.299
    Plugins gain entries for logging and environment variables

    The plugin runtime's list next to tool.register and tool.list now also includes ui.log, env.get and env.set

    found in this entry's text

  7. v2.1.242
    Plugin modules with a $ API that can hook events and redraw the terminal UI

    Plugins can install code that intercepts tool calls and repaints parts of the terminal interface.

    found in this entry's text

First cited

3

The earliest release whose published evidence quoted tool.list was v2.1.323, 12 Nov 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.32312 Nov 2026mcp_call refused: a tool.list hook removed the tool
v2.1.32312 Nov 2026takes "ui.render", "prompt.section", "prompt.context", "prompt.attachment", "tool.describe", "tool.list", "command.describe" or "config.describe"
v2.1.32312 Nov 2026was added by a tool.list hook, and no tool.call hook answered this call

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.

Feedback