# Search tools
Find tools that work on a task lead list. Search by action or exact tool name to get its input schema.
**Request:** `GET https://leadsagent.io/api/v1/tools?query=website%20status&limit=3`
**Access:** Authenticated credential.
**Response:** data contains matching tools and a next instruction.

## Parameters

- `query` (string): Optional. Up to 200 characters. Omit it to list every tool in one line.
- `limit` (integer): Optional. 1–8; default 3. Used when query is set.

## cURL

```sh
curl --fail-with-body --silent --show-error --request GET "$LEADSAGENT_API_BASE/tools?query=website%20status&limit=3" -H "X-API-Key: $LEADSAGENT_API_KEY"
```

## Example response

```
{
  "request_id": "6c4d0c26-8aa3-44b0-a50a-51b832b29465",
  "status": "success",
  "data": {
    "tools": [
      {
        "name": "check_website_status",
        "description": "Checks if each website works.",
        "input": {
          "type": "object",
          "properties": {}
        },
        "output_columns": [
          "website_status"
        ],
        "credits": 0,
        "runs_in_background": true
      }
    ],
    "next": "Call run_tool with task_id, tool and arguments."
  },
  "meta": {}
}
```

## Notes

- The catalog is read-only. Running an ordinary tool needs leads:write.
- Read the input schema before calling run-tool.

[Open the full API reference](https://leadsagent.io/documentation/api-reference)