█

AI/TLDR

Google · 2026-11-19 · notable

Tool Retrieval — Gemini API agents load tool schemas only when needed

In short

Google's Tool Retrieval lets Gemini API agents keep large tool libraries on standby and load a tool's full schema only when a task needs it. It is in preview in the Interactions API.

Google · 2026-11-19 · 3 sources checked

Google hero graphic for Tool Retrieval in the Gemini API

Gemini agents can hold hundreds of tools and pay input tokens only for the ones they use.

What is it?

Tool Retrieval is a Gemini API feature, in preview in the Interactions API, that defers loading of tool definitions. The model sees only each deferred tool's name and description, and asks for the full parameter schema when a task needs it.

How does it work?

You add a tool_search tool and set defer_loading: true on the tools to hold back, including mcp_server tools. Gemini runs the search on the server, so no index is needed, and calls the function in the same request. Setting execution to client lets your own app run the search instead.

Why does it matter?

Large tool libraries usually bloat the prompt, which costs tokens and can hurt tool choice. Deferred schemas stay out of the prompt prefix, so prefix caching keeps working across turns. Google gives no benchmark figures, so measure savings on your own traffic.

Who is it for?

developers building agents with many tools or MCP servers

Try it

Add a tool_search tool and defer_loading: true to your tools in the Interactions API

Sources · 3 outlets

Tags

  • gemini-api
  • tool-retrieval
  • interactions-api
  • agents
  • function-calling
  • mcp
  • google

← All releases · Learn AI