List models (yekar.google-gemini.list-models) | Read | The Gemini models this API key can reach, with each one's token limits and the methods it supports. This is the source of truth for the model argument on the other tools: availability varies by project and by region, and an embedding-only model will not answer a prompt no matter how it is called. Ids come back bare and ready to use - the models/ prefix Google's API returns is part of the resource name, not the id. |
Generate text (yekar.google-gemini.generate-text) | Read | Send a prompt to a Gemini model and return its answer. One request, one answer - this tool holds no conversation state, so anything the model needs to know belongs in prompt or system. Use it for a second opinion from a different model family, for work a specific Gemini model is better at, or wherever an automation needs Gemini text specifically. For an answer grounded in live web results with citations, use Answer with search; for a result that must match a JSON schema, use Extract data. |
Extract data (yekar.google-gemini.extract-data) | Read | Ask a Gemini model for an answer shaped by a JSON Schema, and get back the parsed object rather than prose to hand-parse. Use it to pull fields out of unstructured text, classify against a fixed set of labels, or produce a record another step consumes. Gemini enforces the schema's shape but ignores value constraints such as minimum and maxLength, so validate those yourself if they matter. A blocked or cut-off answer are the two ways to get no data, and both are reported explicitly. |
Answer with search (yekar.google-gemini.answer-with-search) | Read | Answer a question with Gemini grounded in live Google Search results, returning the answer together with the pages it is based on. Use it for anything where current information changes the answer - recent events, current prices or versions, anything past the model's training cutoff. Unsearched answers are rejected by default; set require_search: false to knowingly accept a plain Gemini answer with empty citations. Billed as a grounded request, which costs more than a plain generation. |
Generate image (yekar.google-gemini.generate-image) | Read | Generate an image from a text prompt with an image-capable Gemini model. The image is saved as an attachment on this session - it is not returned inline, because an image is bytes and the result of a tool call is text. One image per call; any commentary the model wrote alongside it comes back as text. |
Count tokens (yekar.google-gemini.count-tokens) | Read | Measure how many input tokens a prompt uses on a given Gemini model, without generating anything or spending output tokens. Use it to size a prompt against a model's input limit before sending it (List models reports that limit), to decide whether text needs splitting, or to estimate cost. Counts are model-specific, so the answer is only valid for the model named. |