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

# search_docs

> Use the `search_docs` MCP tool to search a published tool's official documentation with a natural-language question.

Use `search_docs` after [`search_tools`](/mcp/tools-reference/search-tools) and [`get_tool_context`](/mcp/tools-reference/get-tool-context) when you need deeper answers from that tool's official docs. Pass the exact registry slug and a specific question. UseAgents resolves the tool's docs URL from the registry, then returns query-relevant passages from that documentation host.

## Parameters

| Parameter | Type   | Required | Description                                                     |
| --------- | ------ | -------- | --------------------------------------------------------------- |
| `slug`    | string | Yes      | Exact tool slug selected from a `search_tools` result           |
| `query`   | string | Yes      | Natural-language question to search in the tool's documentation |
| `format`  | string | No       | Response format: `toon` (default) or `json`                     |

## Returns

By default the tool returns data in **Toon**. Pass `format: "json"` for JSON text. Learn more at [toonformat.dev](https://toonformat.dev) and [Response formats](/api-reference/response-format).

| Field     | Type   | Description                                                                          |
| --------- | ------ | ------------------------------------------------------------------------------------ |
| `slug`    | string | Normalized tool slug                                                                 |
| `docsUrl` | string | Documentation URL resolved from the registry                                         |
| `query`   | string | Question that was searched                                                           |
| `results` | array  | Ranked docs hits with `url`, optional `title`, and query-relevant `content` passages |

## Example call

```json theme={null}
{
  "slug": "resend",
  "query": "how do I send attachments"
}
```

## Typical workflow

1. Call [`search_tools`](/mcp/tools-reference/search-tools) with a task-focused query.
2. Choose a slug from the results.
3. Call [`get_tool_context`](/mcp/tools-reference/get-tool-context) for install and quickstart context.
4. Call `search_docs` with the same slug and a specific docs question when you need more depth.

## Related

* [`search_tools`](/mcp/tools-reference/search-tools)
* [`get_tool_context`](/mcp/tools-reference/get-tool-context)
* [`GET /tools/docs/:slug`](/api-reference/tools-docs)