---
title: "Search tools by natural language query"
method: GET
path: "/v1/tools/search"
---

# Search tools by natural language query

`GET /v1/tools/search`

## Request

- Base URL: `https://api.toolrouter.com`
- URL: `https://api.toolrouter.com/v1/tools/search`
- Auth: none required

## Query parameters

- `q` string, required

## Response `200`

Matching tools

- ToolList
  - `tools` Tool[], required
    - `name` string
    - `displayName` string
    - `subtitle` string
    - `description` string
    - `categories` string[]
    - `version` string
    - `skills` Skill[]
      - `name` string, required
      - `displayName` string, required
      - `description` string, required
      - `input` object
      - `outputSchema` object
      - `returns` string
      - `examples` object[]

## Other responses

- `400`: Machine-readable ToolRouter error
- `default`: Machine-readable ToolRouter error

---

[API](https://skmtc.dev/toolrouter/apis/toolrouter-api.md) · [All operations](https://skmtc.dev/toolrouter/apis/toolrouter-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolrouter/apis/toolrouter-api/revisions/b21ed1d64e24?raw)