Image Search
image_searchFind images on the web by text query or reference image and get ranked results with titles, sources, dimensions, thumbnails, and summaries. Use for photos, diagrams, screenshots, or visual references.
Instructions
Find images on the web by text query OR by a reference image — returns ranked results (title, source page, dimensions, thumbnail, description, summary). Pass exactly one of: a text query, an image_url (a picture already on the web), or image_data (base64, for a picture you hold). Never more than one. Use this when the user wants pictures, photos, diagrams, screenshots, or visual references — not for general text web search.
keywords: find images, image search, photos, pictures, screenshots, visual reference, diagram, icon, illustration, reference image
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "image_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results to return (1-10). Default 5. | |
| query | No | Text query describing the images to find. Exactly one of `query`, `image_url` or `image_data` — never more than one. | |
| timeout | No | Request timeout in seconds (1-60). Defaults to 30s if unset. | |
| image_url | No | Public image URL to search by visual similarity. Exactly one of `query`, `image_url` or `image_data` — never more than one. | |
| image_data | No | Base64-encoded image to search by visual similarity, for an image you hold rather than one already on the web. At most 5MB encoded; JPEG, PNG, WEBP, BMP, TIFF, ICO, DIB, ICNS or SGI. A `data:` URI is accepted — its payload is used. Exactly one of `query`, `image_url` or `image_data` — never more than one. | |
| safesearch | No | Adult-content filter. Default strict. | strict |
| exclude_domains | No | Drop results from these domains. | |
| include_domains | No | Only return results from these domains (e.g. 'unsplash.com'). |