Skip to main content
Inspect and configure mounted MCP servers.

tai mcp add

Add MCP config entries to the manifest and hot-reload. The file is ONE entry object, a bare JSON array of entries, or an object carrying an "entries" list. Without --replace an entry whose title already exists is refused. Example: tai mcp add --file entries.json

tai mcp deregister

Detach a single MCP server’s tools by title (the removal counterpart of reload). Runtime-only detach; for persisted removal see remove. Example: tai mcp deregister my-server

tai mcp failed

List the MCP servers skipped by the viability check (down/slow at boot or reload). Example: tai mcp failed

tai mcp pick

Set which of an MCP server’s tools are mounted: an include list, an exclude list, or all. Exactly one of --include, --exclude or --all is given. A pick that would stop mounting a tool something still uses is refused, naming each holder. Example: tai mcp pick my-server --include my-server_search

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

tai mcp reload-failed

Re-probe every failed MCP server and attach the ones now viable. Example: tai mcp reload-failed

tai mcp remove

Remove one MCP config entry by title and hot-reload. Persisted removal (see deregister for runtime-only detach). Example: tai mcp remove my-server

tai mcp schema

Get the JSON schema for one MCP-config entry. Example: tai mcp schema

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

tai mcp status

Snapshot the live MCP binding status. Example: tai mcp status

tai mcp tools

List every tool an MCP server advertised at its bind, with whether the entry picks it and whether it is bound. The answering worker reads the listing it bound the server from; it never starts the server. Each row gives the tool’s served name, whether the entry’s selection picks it, whether it is bound, why a picked tool is not bound, and its description. A name the entry’s selection lists that the server no longer advertises follows as a “not advertised” row. Example: tai mcp tools my-server