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

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

| Group | Access | MCP name |
| --- | --- | --- |
| Boards (beta) | Writes data | `add_to_board` |

## Description [#description]

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

> Save links or short text cards to one of the user's boards, only when they ask. A link is read once and kept with its title and text. Pass board (id or title from list_boards), or newBoardTitle to make a new board. Over MCP only the link and text item types work; the other types refer to a WriteStack Coach chat.

## Arguments [#arguments]

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `board` | `string` | No | Board id or title. In a Coach chat about a board, omit it to use that board. Max length 200. |
| `items` | `object[]` | Yes | Min items 1. Max items 30. |
| `items[].type` | `string` | Yes |  |
| `items[].url` | `string` | Yes | A public http or https address. The page is read once and kept. Min length 4. Max length 2000. |
| `newBoardTitle` | `string` | No | Make a new board with this name and add the items there. Min length 1. Max length 120. |
| `note` | `string` | No | The user's own reason for saving, in their words. Only when they gave one. Max length 500. |

## 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": "add_to_board",
    "arguments": {
      "items": [
        {
          "type": "…",
          "url": "…"
        }
      ]
    }
  }
}
```

## Annotations [#annotations]

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

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