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

# tai mcp

> Inspect and configure mounted MCP servers.

Inspect and configure mounted MCP servers.

```console theme={null}
$ tai mcp [OPTIONS] COMMAND [ARGS]...
```

## `tai mcp deregister`

Detach a single MCP server's tools by title (the removal counterpart of reload).

Example: `tai mcp deregister my-server`

```console theme={null}
$ tai mcp deregister [OPTIONS] TITLE
```

| Argument | Description                    |
| -------- | ------------------------------ |
| `TITLE`  | MCP server title. *(required)* |

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `--target` `TEXT`      | A worker to restrict the fan-out to (repeatable). |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.            |

## `tai mcp failed`

List the MCP servers skipped by the viability check (down/slow at boot or reload).

Example: `tai mcp failed`

```console theme={null}
$ tai mcp failed [OPTIONS]
```

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `--target` `TEXT`      | A worker to restrict the listing to (repeatable). |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.            |

## `tai mcp reload`

Reload a single MCP server by title.

Without `--target` the response is the single-worker status; with one or more
the confirmed fleet fan-out is awaited and per-worker results are returned.

Example: `tai mcp reload my-server`

```console theme={null}
$ tai mcp reload [OPTIONS] TITLE
```

| Argument | Description                    |
| -------- | ------------------------------ |
| `TITLE`  | MCP server title. *(required)* |

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `--target` `TEXT`      | A worker to restrict the fan-out to (repeatable). |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.            |

## `tai mcp reload-failed`

Re-probe every failed MCP server and attach the ones now viable.

Example: `tai mcp reload-failed`

```console theme={null}
$ tai mcp reload-failed [OPTIONS]
```

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `--target` `TEXT`      | A worker to restrict the fan-out to (repeatable). |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.            |

## `tai mcp schema`

Get the JSON schema for one MCP-config entry.

Example: `tai mcp schema`

```console theme={null}
$ tai mcp schema [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai mcp set`

Replace the MCP config section from a JSON file and hot-reload.

The file is the full replacement MCP list, either a bare JSON array or an
object carrying an `"mcp"` list.

Example: `tai mcp set --file mcp.json`

```console theme={null}
$ tai mcp set [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--file` `FILE`        | A JSON file with the full 'mcp' list.  |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai mcp status`

Snapshot the live MCP binding status.

Example: `tai mcp status`

```console theme={null}
$ tai mcp status [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |