{"name":"tool.call","slug":"tool-call","family":"setting","title":"Settings keys","noun":"settings key","description":"Tools a plugin registers reach the model through a local loopback MCP server.","description_source":"entry","described_by":{"version":"2.1.242","anchor":"plugin-registered-tools-are-served-over-a-local-mcp-server"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.281","released_at":"2026-09-23 17:01:17","spans":2}},"aliases":[],"entries":[{"version":"2.1.309","anchor":"claude-test-plugin-explorer-prompt-forbids-credential-files","heading":"Claude Test's explorer agent may no longer open credential files or leave the project","line":"The Claude Test plugin's explorer agent is now told to use only Read, Grep and Glob, avoid credential files and stay inside the project folder","released_at":"2026-10-22 20:34:13","reason":"found in this entry's text"},{"version":"2.1.309","anchor":"claude-test-plugin-gains-toolcall-and-many-more-host-calls","heading":"Built-in Claude Test plugin can do more, with tighter rules for its explorer","line":"The bundled Claude Test plugin now handles the tool.call hook and more host calls, and its explorer is told to stay away from credential files","released_at":"2026-10-22 20:34:13","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"hook-default-responses-become-functions-with-reason","heading":"Plugin hook denials now carry a reason","line":"Default deny responses for plugin hooks such as tool.check and agent.spawn now include a reason alongside the decision","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.287","anchor":"remote-shell-tool-output-previews-and-progress-forwarded-to","heading":"Remote shell commands now pass on live progress and an output preview","line":"Shell commands run for a remote session now pass on live progress and keep the end of their output as a preview","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.287","anchor":"shell-progress-now-captures-live-output-for-posttooluse-hook","heading":"Remote sessions keep live shell output when no hooks are set","line":"In remotely served sessions, Claude Code now keeps the latest live output of shell commands unless hooks are set up","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"plugin-served-mcp-tool-error-names-the-mcp-server-correctly","heading":"Error for an unanswered plugin MCP tool call now shows the correct tool name pattern","line":"When no `tool.call` hook answers a plugin-served MCP tool, the hint now builds the tool name from the MCP server's name, not the plugin's","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"hooks-modules-toolcall-pinned-key-matchers-and-runcommands","heading":"Hook modules that don't match a tool call are skipped earlier","line":"Claude Code now checks hook modules against key fields of a tool call itself and skips those that don't match, instead of sending every call to every module","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"hooktoolcall-payload-strips-isreadonly","heading":"Hook\/tool.call payload strips isReadOnly","line":"tool.call events now have their isReadOnly field removed before they are passed on","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"toolcall-hook-event-schema-gains-a-measure-combinator","heading":"tool.call hook-event schema gains a measure combinator","line":"The tool.call hook event gained a 'measure' step that combines context across related events","released_at":"2026-09-17 20:20:31","reason":"named in this entry, found in this entry's text"},{"version":"2.1.269","anchor":"new-toolcheck-hook-event-wired-into-the-tool-approval-pip","heading":"New tool.check hook event wired into the tool-approval pipeline","line":"New tool.check hook can override a hook's earlier 'deny' decision on a tool call","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"}],"entries_total":19,"docs":[{"source":"api","path":"api\/opentelemetry\/spans","title":"spans","documented":false},{"source":"api","path":"manage-claude\/opentelemetry","title":"opentelemetry","documented":false},{"source":"api","path":"managed-agents\/events-and-streaming","title":"events-and-streaming","documented":false},{"source":"api","path":"managed-agents\/workflow-runs","title":"workflow-runs","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"plugins\/cli-reference","title":"Plugin commands reference","documented":false},{"source":"claude-code","path":"plugins\/mods\/admin","title":"Manage mods for your organization","documented":false},{"source":"claude-code","path":"plugins\/mods\/api","title":"Use the mods API","documented":false},{"source":"claude-code","path":"plugins\/mods\/create","title":"Create a mod","documented":false}],"docs_total":12,"gates":[],"related":[{"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.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"},{"name":"toolResultRemedy","slug":"toolresultremedy","description":"Tool results can now carry an internal 'remedy' value passed through to the assistant-visible message"},{"name":"toolRules","slug":"toolrules","description":"Permission tool rules can now be redacted properly when exporting config."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/tool-call","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}