> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Tool Commands

> Define tools, bundle toolsets, and inspect tool calls.

Define tools, bundle toolsets, and inspect tool calls.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl tools list`

List tools

```bash
bctrl tools list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `--space <id>`         | Filter by space id                  |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl tools get`

Get a tool

```bash
bctrl tools get <id>
```

## `bctrl tools create`

Create a tool

```bash
bctrl tools create
```

## `bctrl tools patch`

Update a tool

```bash
bctrl tools patch <id>
```

## `bctrl tools call`

Call a tool and wait for its result

```bash
bctrl tools call <toolRef> [flags]
```

| Flag             | Description                                      |
| ---------------- | ------------------------------------------------ |
| `--runtime <id>` | Runtime whose active Run should execute the Tool |

## `bctrl tools start`

Start an asynchronous tool call

```bash
bctrl tools start <toolRef> [flags]
```

| Flag             | Description                                      |
| ---------------- | ------------------------------------------------ |
| `--runtime <id>` | Runtime whose active Run should execute the Tool |

## `bctrl tools delete`

Delete a tool

```bash
bctrl tools delete <id> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |

## `bctrl toolsets list`

List toolsets

```bash
bctrl toolsets list [flags]
```

| Flag           | Description        |
| -------------- | ------------------ |
| `--space <id>` | Filter by space id |

## `bctrl toolsets get`

View a toolset

```bash
bctrl toolsets get <id>
```

## `bctrl toolsets create`

Create a toolset

```bash
bctrl toolsets create
```

## `bctrl toolsets patch`

Edit a toolset

```bash
bctrl toolsets patch <id>
```

## `bctrl toolsets delete`

Delete a toolset

```bash
bctrl toolsets delete <id> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |

## `bctrl tool-calls list`

List tool calls

```bash
bctrl tool-calls list [flags]
```

| Flag                   | Description           |
| ---------------------- | --------------------- |
| `--space <id>`         | Space id              |
| `--tool <id>`          | Filter by tool id     |
| `--run <id>`           | Filter by run id      |
| `--status <status>`    | Filter by status      |
| `--caller-type <type>` | Filter by caller type |

## `bctrl tool-calls cancel`

Cancel a tool call

```bash
bctrl tool-calls cancel <toolCallId>
```

## `bctrl tool-calls respond`

Respond to a tool input request

```bash
bctrl tool-calls respond <toolCallId>
```

## `bctrl tool-calls result`

Wait for and return a tool call result

```bash
bctrl tool-calls result <toolCallId>
```

## `bctrl tool-calls get`

View a tool call

```bash
bctrl tool-calls get <id>
```