{"name":"tools","slug":"tools","family":"setting","title":"Settings keys","noun":"settings key","description":"Tool discovery uses a newer path with retries on servers that negotiate the modern protocol; older servers are unchanged.","description_source":"entry","described_by":{"version":"2.1.221","anchor":"tools-list-uses-the-new-client-listtools-path-with-retry-bac"},"presence":{"first_seen":"2.1.284","removed_in":null,"in_current_build":true,"newest_mined":"2.1.285","builds":2,"mined_builds":128,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.285","anchor":"typed-tool-flags-snapshotted-maxturns-passthrough","heading":"Tool restrictions and turn limits now carry over to spawned sessions","line":"Spawned sessions now keep your `disallowedTools` and `tools` restrictions and your `maxTurns` limit","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"post-turn-memory-config-gains-extract-transport-tools-o","heading":"Post-turn memory config accepts an extract_transport choice","line":"The post-turn memory config now takes an extract_transport option, \"tools\" or \"text\", defaulting to \"tools\"","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-can-hand-in-process-mcp-server-manifests-to-the-cli-at-i","heading":"SDK can hand in-process MCP server manifests to the CLI at initialize","line":"The Agent SDK can now read tool lists from in-process MCP servers itself and pass them to the CLI when it starts","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.274","anchor":"internal-session-options-gain-a-shared-toolcatalog-object","heading":"Internal: session options gain a shared toolCatalog object","line":"Internal: sessions now pass around a shared toolCatalog object instead of calling tool-lookup functions directly","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"mcp-serve-now-advertises-and-sends-toolslist-changed-notifi","heading":"mcp serve now advertises and sends tools\/list_changed notifications","line":"claude mcp serve now tells connected clients when its tool list changes","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"tether-thread-continuation-requests-can-omit-system-prompt","heading":"'Tether' thread-continuation requests can omit system prompt\/tools when continuing, behind two off-by-default flags, with a fingerprint-mismatch circuit breaker","line":"Continuing a server-side conversation thread can now skip resending the system prompt and tools list, with a fallback if the server disagrees","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"model-parameter-allowlist-changed-from-array-to-set","heading":"Model-parameter allowlist changed from array to Set","line":"Internal list of allowed API request fields switched from an array to a Set","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"new-tool-schema-invalid-error-classification-for-400s-refere","heading":"New tool_schema_invalid error classification for 400s referencing tools.N.input_schema","line":"API 400 errors about an invalid tool input schema now get their own error type instead of being generic","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"new-unknown-tools-error-case-for-artifact-mcp-manifests","heading":"New \"unknown_tools\" error case for artifact MCP manifests","line":"Publishing an artifact now fails clearly if its MCP manifest lists tool names the connector doesn't actually have","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"sdk-mcp-servers-can-now-skip-the-control-channel-handshake-v","heading":"SDK MCP servers can now skip the control-channel handshake via manifests","line":"SDK-registered in-process MCP servers can now skip a round-trip handshake at session start","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"}],"entries_total":26,"docs":[{"source":"api","path":"about-claude\/glossary","title":"glossary","documented":false},{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"about-claude\/pricing","title":"pricing","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/commerce-agents","title":"commerce-agents","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/customer-support-chat","title":"customer-support-chat","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/overview","title":"overview","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/best-practices","title":"PDF Processing","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/claude-api-skill","title":"claude-api-skill","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/enterprise","title":"enterprise","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/tools","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}