Sign in
Tools

List server tools

Lists every server tool OpenRouter can run on behalf of a model: accepted tools[].type spellings per API format, the engines behind it with their pricing, and how many endpoints run it natively.

get/tools

Query parameters

offsetinteger nullable

Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned

Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned

limitinteger

Maximum number of records to return (max 100). When both offset and limit are omitted, the full list is returned

Example:50

Maximum number of records to return (max 100). When both offset and limit are omitted, the full list is returned

api_format'responses' | 'chat-completions' | 'anthropic-messages'

Only tools usable on this API format

Example:responses

Only tools usable on this API format

Response

The server tool catalog

total_countinteger required

Total number of tools

Example response

{
  "data": [
    {
      "aliases": [
        {
          "output_names": [
            {
              "name": "web_search",
              "type": "web_search_call"
            }
          ],
          "type": "web_search_20250305"
        }
      ],
      "default_engine": "native",
      "engines": [
        {
          "byok": "none",
          "data_regions": [
            "global",
            "us"
          ],
          "default_mode": "auto",
          "executed_by": "openrouter",
          "id": "exa",
          "name": "Exa",
          "pricing": [
            {
              "mode": "auto",
              "price": "0.007",
              "unit": "request"
            }
          ],
          "pricing_source": "openrouter"
        }
      ],
      "fallback_engine": "exa",
      "id": "openrouter:web_search",
      "input_schema": {
        "properties": {},
        "type": "object"
      },
      "name": "Web search",
      "native_support": {
        "endpoint_count": 18,
        "model_count": 12
      },
      "output_schema": {
        "properties": {},
        "type": "object"
      },
      "parameters_schema": {
        "properties": {},
        "type": "object"
      },
      "status": "active"
    }
  ],
  "total_count": 12
}

Changes

Changed in 1 of the 339 revisions of this API.1