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

# Commands overview

> Reference for mcpconfig commands and options

## Usage

```bash theme={null}
mcpconfig <command> [options]
```

## Commands

| Command           | Description                                                                                                                                                                                                                        |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **list-clients**  | List MCP config file locations. By default shows only configs that were **found** on disk.                                                                                                                                         |
| **list-servers**  | Read all found **JSON** configs and **Codex** `config.toml`, extract MCP servers (`mcpServers` or `mcp_servers`), and print a table: app name, server name, command, args.                                                         |
| **add-server**    | Interactive flow: select one or more apps (↑/↓ move, Space toggle, "Select all", Enter to confirm), then enter server name, command, and args. Writes to every selected config (JSON or Codex TOML).                               |
| **delete-server** | Interactive flow: enter server name to delete, then select one or more apps that contain that server (↑/↓ move, Space toggle, "Select all", Enter to confirm). Removes the server from every selected config (JSON or Codex TOML). |

## Options

| Option    | Short  | Description                                                                        |
| --------- | ------ | ---------------------------------------------------------------------------------- |
| **--all** | **-a** | **Only for list-clients.** Show every known config location (found and not found). |

## Examples

```bash theme={null}
# See which MCP configs exist and where they are
mcpconfig list-clients

# See all known config locations (including missing ones)
mcpconfig list-clients --all

# See all MCP servers from every found JSON and Codex TOML config in one table
mcpconfig list-servers

# Interactively add an MCP server to one or more configs
mcpconfig add-server

# Interactively remove an MCP server by name from selected configs
mcpconfig delete-server
```

## Output

* **list-clients** — One line per config: app name, ✓ or ✗ (found or not), and the full path when found.
* **list-servers** — A table with columns: **APP**, **SERVER**, **COMMAND**, **ARGS**. JSON configs use `mcpServers`; Codex uses `~/.codex/config.toml` and `[mcp_servers.<name>]`. Other TOML/YAML configs are skipped.
* **add-server** — Writes the new server to each selected config; shows success or an error.
* **delete-server** — Removes the server from each selected config; shows success, "Server not found", or an error.

## See also

<CardGroup cols={2}>
  <Card title="list-clients" icon="folder-open" href="/commands/list-clients">
    List MCP config file locations.
  </Card>

  <Card title="list-servers" icon="list" href="/commands/list-servers">
    List MCP servers from found JSON and Codex TOML configs.
  </Card>

  <Card title="add-server" icon="plus" href="/commands/add-server">
    Interactively add an MCP server to configs.
  </Card>

  <Card title="delete-server" icon="trash" href="/commands/delete-server">
    Interactively remove an MCP server from configs.
  </Card>
</CardGroup>