> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pomerado.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Find a tool

> Search for a ready-made tool that does your task on a website.

Search for a tool before you build one. A tool does one task on one website, such as searching Google Flights or adding items to an Instacart cart, and runs in seconds.

## Search by task or site

Pass a `query`, a `site_url`, or both. A site URL can be a bare domain or a pasted address.

```json theme={null}
{
  "name": "find_website_tool",
  "arguments": {
    "query": "search flights",
    "site_url": "https://www.google.com/travel/flights"
  }
}
```

Over REST, send the same fields to `GET /v1/tools`. Both answer one page in `data`; pass `next_cursor` back as `cursor` for the next page.

With both a query and a site, the first page also lists `possible_matches`: up to 50 of the site's other tools that may cover the task though the words didn't match. Check them before you build another.

## Read a tool

| Field | What it tells you |
| - | - |
| `id` | The `tool_id` you pass to run it |
| `effect` | `read` when it only looks things up, `write` when it changes the site |
| `input_schema`, `output_schema` | What it takes and what it returns |
| `login` | What its sign-in takes, or `null` when it needs no login |
| `integration_id`, `mcp_name` | Its integration, and its name on that integration's MCP |

To read one tool later, pass its `id` alone to `find_website_tool`, or call `GET /v1/tools/{id}`.

## When nothing fits

[Build a tool](/guides/build/overview). It takes about 10 minutes, and the tool is reused after that.

<Accordion title="Details">
  * You see public tools and your team's private ones. A disabled tool never appears.
  * `integration_id` limits the search to one integration's tools.
  * Without credentials, the search lists only public read-only tools that need no login, with a `notice` on how to see the rest. See [Try without a key](/quickstart/try-without-a-key).
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.