Skip to content

Tool

search_images

Search images

Read-onlyIdempotent
SurfacesChat agentMCPCLI

Find stock images (or generate an AI placeholder) for a campaign or newsletter body. mode='search' queries the okslop stock library by keyword; mode='generate' returns a deterministic AI-generated placeholder for a prompt (use when nothing fits or you need a hero image). Returns image URLs you can drop into markdown as ![alt](url). Read-only — picking an image is your job; nothing is inserted or sent.

CLI: tinbox search-images

Parameters

NameTypeRequiredDescription
querystringyesSearch keyword (mode='search') or the image prompt (mode='generate').
modesearchgenerateno'search' the stock library (default) or 'generate' an AI placeholder.
limitintegernoMax images to return (default 12; ignored for generate).
orientationlandscapeportraitsquarenoPreferred orientation. Landscape suits email hero images.

Example

json
{
  "query": "invoice"
}