# search_boards (/docs/build/mcp-reference/search_boards)

{/* GENERATED by scripts/generate-mcp-reference.mjs from the MCP server tools/list. Do not edit. */}

| Group | Access | MCP name |
| --- | --- | --- |
| Boards (beta) | Read-only | `search_boards` |

## Description [#description]

The description the MCP server sends to the model, word for word. Its rules apply to every call.

> Find saved items across all of the user's boards by words in their text, author, link or the user's note. Returns the board and each item's ref for get_board_item.

## Arguments [#arguments]

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | `string` | Yes | Words to find, like an author, topic or phrase. Min length 2. Max length 200. |

## Example call [#example-call]

The smallest valid request: required arguments only, with placeholder values.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_boards",
    "arguments": {
      "query": "…"
    }
  }
}
```

## Annotations [#annotations]

| Hint | Value |
| --- | --- |
| `readOnlyHint` | `true` |
| `destructiveHint` | `false` |
| `openWorldHint` | `false` |

The full input and output JSON Schemas for every tool are in [/mcp-tools.json](/mcp-tools.json).
