Tool Retrieval in the Gemini API
Google put Tool Retrieval in preview in the Gemini Interactions API. Agents load tool parameter schemas on demand instead of sending the whole tool library in every prompt.
Developers add a tool_search tool and set defer_loading to true on the tools they want deferred. The model still sees each deferred tool's name and description, and the API loads the full schema only when the model asks for that tool, all within a single request. It works with prefix caching, server-side and client-side retrieval, and remote MCP servers.
- Date
- Thursday 19 November 2026
- Lab
- Kind
- feature
- Access
- closed API
- Price
- No separate charge. Standard input and output token rates apply.
Works with Gemini 3.6 and later models in the Interactions API. The page gives no measured token savings.
Sources
This record was partly confirmed: some claims could not be checked on 19 November 2026. How we check