# Introducing Tool Retrieval in the Gemini API

Source: [Google](https://blog.google/innovation-and-ai/technology/developers-tools/gemini-api-tool-retrieval/)  
Feed7 permalink: https://feed7.dev/p/introducing-tool-retrieval-in-the-gemini-api-57728669e0  
Published: 2026-11-19T00:00:00.000Z  
Trust: Official Source (official_source)

## Why Included

Defer long-tail tool schemas while keeping frequent tools loaded, then measure token savings because retrieved schemas remain billable.

## Source Summary

Gemini Tool Retrieval defers full tool schemas until an agent needs them, keeping large tool libraries out of most requests. Measure token use on your traffic, since loaded schemas remain billable in the conversation.

## Practical Implication

For agents with large tool libraries, leave frequent tools loaded and defer the long tail with `tool_search` and `defer_loading: true`. Remote MCP tools can also be loaded on demand, and deferred schemas keep the prompt prefix stable for caching.

## Agent-Ready Context

**Tool Retrieval** is in preview in the Gemini Interactions API. Deferred tools keep their names and descriptions visible, while their parameter schemas load only after the model requests a specific tool; the search and call happen in one API request.

For agents with large tool libraries, leave frequent tools loaded and defer the long tail with `tool_search` and `defer_loading: true`. Remote MCP tools can also be loaded on demand, and deferred schemas keep the prompt prefix stable for caching.

There is no separate feature charge, but search adds a small fixed input-token block and loaded schemas are billed as input for the rest of the conversation. Savings depend on how many schemas remain unused, so measure against your own traffic.

## Context Map

- Layer: context
- Domains: coding
- Topics: tool-use, context-engineering, context-caching

## Uncertainty

- None recorded.

## Agent Instruction

Use this item as source-backed context. Do not invent claims beyond the linked source. If this item conflicts with another source, call out the conflict.
