---
title: "Search tools by keyword"
method: GET
path: "/api/tools/search"
tags: ["discovery"]
---

# Search tools by keyword

`GET /api/tools/search`

## Request

- Base URL: `https://claw-link.dev`
- URL: `https://claw-link.dev/api/tools/search`
- Auth: one of:
  - API key in header `x-clawlink-api-key`
  - HTTP bearer

## Query parameters

- `query` string, required
- `integration` string
- `limit` integer

## Response `200`

Matching tools

- object
  - `tools` Tool[], required
    - `integration` string, nullable: Integration slug, for example "gmail".
    - `name` string, nullable: Tool name to pass to executeTool.
    - `description` string
    - `inputSchema` object, nullable: JSON Schema for the arguments object. Null or a placeholder in list responses; hydrated by describeTool.
    - `canonical` object: Canonical summary: integration_id, action, and default connection state.
  - `count` integer, required
  - `query` string, required
  - `integration` string, nullable

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/claw-link/apis/clawlink-agent-api.md) · [All operations](https://skmtc.dev/claw-link/apis/clawlink-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/claw-link/apis/clawlink-agent-api/revisions/6ce0c62d160a?raw)