Search Models Server Tool - Model Discovery for Any Model

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.

The 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:

{
  "type": "openrouter:experimental__search_models",
  "parameters": {
    "max_results": 5
  }
}

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:

{
  "models": [
    {
      "id": "anthropic/claude-sonnet-4.5",
      "name": "Anthropic: Claude Sonnet 4.5",
      "description": "...",
      "context_length": 1000000,
      "input_modalities": ["text", "image", "file"],
      "output_modalities": ["text"],
      "series": "Claude"
    }
  ],
  "total_results": 12,
  "showing": 1
}

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

Server Tools Overview. Learn about server tools
Subagent. Delegate tasks to a worker model
Models. Learn about the OpenRouter model catalog

⌘I

Overview

Models & Routing

Features

Ori

Privacy

Best Practices

Community

Search Models

Quick Start

Configuration

Call Arguments

Response

Pricing

Next Steps

​Quick Start

​Configuration

​Call Arguments

​Response

​Pricing

​Next Steps

Quick Start

Configuration

Call Arguments

Response

Pricing

Next Steps