# kindgi mcp

> Manage MCP server entries in .mcp.json (add / list / remove / presets)

## `kindgi mcp`

**Synopsis**

```sh signature
kindgi mcp <command>
```

Manage MCP server entries in .mcp.json (add / list / remove / presets).

**Commands**

| Command                                                                                        | Description                                         |
| ---------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [`kindgi mcp add`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp-add)         | Add an MCP server entry to .mcp.json from a preset. |
| [`kindgi mcp list`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp-list)       | List MCP servers configured in .mcp.json.           |
| [`kindgi mcp remove`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp-remove)   | Remove a server entry from .mcp.json.               |
| [`kindgi mcp presets`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp-presets) | List available MCP presets shipped with the CLI.    |

**See also**

- [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md)

### `kindgi mcp add`

**Synopsis**

```sh signature
kindgi mcp add <KIND> --secret=<name> [--env=<name>] [--scope=<kind>[:id]] [--server-name=<label>] [--path=<pack-dir>] [--force]
```

Add an MCP server entry to .mcp.json from a preset.

**Options**

| Option                  | Default                                                                             | Description                                                                                                             |
| ----------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `--env <value>`         | `local`                                                                             | The environment whose env files hold the secret. Default: `local`.                                                      |
| `--force`               | off                                                                                 | Replace an entry with the same name. By default `add` refuses.                                                          |
| `--path <value>`        | the current directory                                                               | The pack root, where `.mcp.json` is. Default: the current directory.                                                    |
| `--scope <value>`       | `tenant`                                                                            | The secret's scope, recorded in the entry: `tenant` (default), `org:<id>` or `project:<id>`.                            |
| `--secret <value>`      | required                                                                            | The secret's name in the pack's env files for `--env`; the server gets its value at start, never `.mcp.json`. Required. |
| `--server-name <value>` | derived from `--secret` (lowercased, trailing `_url`/`_key`/`_token` etc. stripped) | The entry's name in `.mcp.json`. Default: derived from `--secret` (`MY_DB_URL` becomes `my_db`).                        |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md):

```sh
pnpm exec kindgi mcp add postgres --secret=MY_DB_URL
```

**See also**

- [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md)
- [`kindgi mcp`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp)

### `kindgi mcp list`

**Synopsis**

```sh signature
kindgi mcp list [--path=<pack-dir>]
```

List MCP servers configured in .mcp.json.

**Options**

| Option           | Default               | Description                                                          |
| ---------------- | --------------------- | -------------------------------------------------------------------- |
| `--path <value>` | the current directory | The pack root, where `.mcp.json` is. Default: the current directory. |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

List the servers in the current pack's .mcp.json.

```sh
kindgi mcp list
```

List the servers of a pack in another directory.

```sh
kindgi mcp list --path=./acme-pack
```

**See also**

- [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md)
- [`kindgi mcp`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp)

### `kindgi mcp remove`

**Synopsis**

```sh signature
kindgi mcp remove <SERVER_NAME> [--path=<pack-dir>]
```

Remove a server entry from .mcp.json. Idempotent.

**Options**

| Option           | Default               | Description                                                          |
| ---------------- | --------------------- | -------------------------------------------------------------------- |
| `--path <value>` | the current directory | The pack root, where `.mcp.json` is. Default: the current directory. |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

Remove a server entry from .mcp.json.

```sh
kindgi mcp remove my_db
```

Remove an entry from a pack in another directory.

```sh
kindgi mcp remove my_db --path=./acme-pack
```

**See also**

- [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md)
- [`kindgi mcp`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp)

### `kindgi mcp presets`

**Synopsis**

```sh signature
kindgi mcp presets
```

List available MCP presets shipped with the CLI.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md):

```sh
pnpm exec kindgi mcp presets
```

**See also**

- [Your coding agent](https://docs.kindgi.com/v0.1.9/start/coding-agents.md)
- [`kindgi mcp`](https://docs.kindgi.com/v0.1.9/reference/cli/mcp.md#kindgi-mcp)