{"name":"tool.list","slug":"tool-list","family":"setting","title":"Settings keys","noun":"settings key","description":"Plugins can install code that intercepts tool calls and repaints parts of the terminal interface.","description_source":"entry","described_by":{"version":"2.1.242","anchor":"plugin-modules-with-a-api-that-can-hook-events-and-redraw-th"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.323","builds":0,"mined_builds":162,"first_cited":{"version":"2.1.323","released_at":"2026-11-12 20:29:28","spans":3}},"aliases":[],"entries":[{"version":"2.1.323","anchor":"toollist-hook-lets-plugin-hooks-modules-add-and-remove-sess","heading":"Plugin hooks can now add and remove the tools Claude has in a session","line":"A new tool.list hook event lets a plugin's hooks module remove tools from a session or add new ones","released_at":"2026-11-12 20:29:28","reason":"named in this entry, found in this entry's text"},{"version":"2.1.323","anchor":"mods-runtime-new-mcpconnect-and-toollist-hooks-and-a-plu","heading":"Plugins can now react to MCP connections and change the tool list","line":"Plugins gain `mcp.connect` and `tool.list` hooks, so they can step in on MCP connections and add or remove tools in a session","released_at":"2026-11-12 20:29:28","reason":"named in this entry, found in this entry's text"},{"version":"2.1.323","anchor":"hookevent-surface-gains-toollist","heading":"Add-ons can now hook into the list of tools","line":"Add-on code can now respond to a `tool.list` event when Claude Code lists its tools","released_at":"2026-11-12 20:29:28","reason":"named in this entry, found in this entry's text"},{"version":"2.1.323","anchor":"mcp-calls-now-run-toollist-hooks-before-the-call","heading":"MCP tool calls are refused when a hook has removed the tool","line":"Before an MCP tool call runs, tool.list hooks are now consulted, and the call is refused if one of them removed the tool","released_at":"2026-11-12 20:29:28","reason":"named in this entry, found in this entry's text"},{"version":"2.1.323","anchor":"tool-list-now-rebuilt-through-a-toollist-hook-mechanism","heading":"The list of available tools can now be rebuilt when plugins signal a change","line":"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","released_at":"2026-11-12 20:29:28","reason":"named in this entry, found in this entry's text"},{"version":"2.1.299","anchor":"plugin-runtime-mods-gain-uilog-envget-envset","heading":"Plugins gain entries for logging and environment variables","line":"The plugin runtime's list next to tool.register and tool.list now also includes ui.log, env.get and env.set","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"plugin-modules-with-a-api-that-can-hook-events-and-redraw-th","heading":"Plugin modules with a $ API that can hook events and redraw the terminal UI","line":"Plugins can install code that intercepts tool calls and repaints parts of the terminal interface.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"}],"entries_total":7,"docs":[{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false}],"docs_total":1,"gates":[],"related":[{"name":"tool.call","slug":"tool-call","description":"Tools a plugin registers reach the model through a local loopback MCP server."},{"name":"tool.check","slug":"tool-check","description":"Plugin hooks can now react to tool-call dry-runs, config changes, and session attach\/detach events."},{"name":"tool.describe","slug":"tool-describe","description":"Plugin hooks are limited in what they may rewrite, and cannot take over question prompts."},{"name":"tool.output","slug":"tool-output","description":"A tool.output telemetry event can carry file contents, diffs and bash commands after a successful tool call, behind a gate."},{"name":"toolAliases","slug":"toolaliases","description":"The internal per-session context object gained many new fields covering effort, hooks, tools, and skills"},{"name":"toolCalls","slug":"toolcalls","description":null},{"name":"toolCount","slug":"toolcount","description":"When an `mcp_status` live reply would be too large, it now sends a count of each server's tools instead of the full list"},{"name":"toolPermissionContext","slug":"toolpermissioncontext","description":"The auto-mode suggestion dialog now just dismisses itself instead of switching your session to auto."},{"name":"toolPolicy","slug":"toolpolicy","description":"Legacy managed MCP server config fields now have a formal deprecation and rewrite system."},{"name":"toolResultCopiesOnDisk","slug":"toolresultcopiesondisk","description":"A slim mode can blank file contents and command output in the copies of tool results Claude Code saves to disk"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/tool-list","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}