search_images
Search Google Images by query and return image URLs, thumbnails, dimensions, and source pages for visual research, moodboards, or gallery layouts.
Instructions
Google Image search via Serper API. Returns image URLs, thumbnails, dimensions, and source pages. Use layout=gallery for a renderable visual grid (designers/moodboards). Always rich — never compacted.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_images"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | Restrict to domain (e.g. dribbble.com, behance.net, unsplash.com). | |
| size | No | Filter by pixel dimensions, client-side via W×H (longest side: small <640, medium <1280, large <2000, xlarge ≥2000; images without dimensions are kept). | |
| query | Yes | Image search query. | |
| layout | No | list (default) or gallery (renderable ![thumb] grid). | list |
| country | No | ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). Default: "US". | |
| ui_lang | No | UI language (e.g. "en-US"). Default: "en". | |
| provider | No | Search backend: auto (failover chain), serper, tavily, brave, exa, firecrawl. Default: auto. | auto |
| max_chars | No | Truncate response to this many characters (0 = no limit). | |
| verbosity | No | Output density: auto (server picks per audience), compact (~800 tokens, dev fast path), standard (KG+Box+10), full (everything, always for places/shopping/images/scholar). Default: auto. | auto |
| safesearch | No | "off" | "moderate" | "strict". Default: "moderate". | moderate |
| num_results | No | Results (1–20, default 10). Note: >10 results uses 2 Serper credits. | |
| orientation | No | Aspect filter, client-side via W×H (images without dimensions are kept). | |
| search_lang | No | Language code (e.g. "en", "de"). Default: "en". | |
| snippets_only | No | Return 1-line snippets only (token-saving for agents). Default: false. | |
| link_resolution | No | Google result links beyond the top 3 may come back as google.com/goto redirects. "auto" (default): top 3 resolved, any leftover goto links get a search_id for resolve_links. "all": also resolve every link now (free, but adds ~30 s when goto links are present). "none": fastest, links exactly as Google returns them. |