Beta
BetaServer tools are currently in beta. The API and behavior may change. This tool is experimental — when it graduates, the tool type is likely to be renamed (dropping the experimental__ prefix), which would be a breaking change for requests using the current name.
openrouter:experimental__search_models server tool lets a model search and filter the OpenRouter model catalog. The model can look up models by name, capabilities, modalities, and other attributes — useful for agents that pick models dynamically, for example with the Subagent tool.
Quick Start
Configuration
The search models tool accepts an optional max_results parameter:
| Parameter | Type | Default | Description |
|---|
max_results | integer | 5 | Maximum number of models to return per call. Between 1 and 20 |
Call Arguments
The model generates the search arguments. All fields are optional — an empty call browses the full catalog:
| Field | Type | Description |
|---|
query | string | Free-text search matched against model names, slugs, and descriptions |
input_modalities | string[] | Filter by supported input modalities (text, image, file, audio, video). Returns models that support ALL specified modalities |
output_modalities | string[] | Filter by supported output modalities (e.g. text, image, embeddings, audio). Returns models that support ALL specified modalities |
min_context_length | integer | Minimum context length in tokens |
series | string | Filter by model series/family group (e.g. Claude, GPT, Gemini) |
Response
The tool returns matching models with their key attributes:
total_results is the number of models that matched the filters; showing is how many were returned after applying max_results.
Pricing
There is currently no separate charge for the search models tool; you pay only for standard token usage.
Next Steps
