Command reference
deployments mcp-connection
MCP runtime connections
| Command | Summary |
|---|---|
deployments mcp-connection create | Create an MCP connection |
deployments mcp-connection list | List MCP connections |
deployments mcp-connection show | Show an MCP connection |
deployments mcp-connection revoke | Revoke an MCP connection |
deployments mcp-connection create
Create an MCP connection.
deployments mcp-connection create --server <server>- Calls
POST /v1/mcp-connections(SDKcreateMcpConnection). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--server | string | yes | MCP server ID |
Also accepts the global flags.
deployments mcp-connection list
List MCP connections.
deployments mcp-connection list- Calls
GET /v1/mcp-connections(SDKlistMcpConnections). - Needs an environment:
--envor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size |
Also accepts the global flags.
deployments mcp-connection show
Show an MCP connection.
deployments mcp-connection show <id>- Calls
GET /v1/mcp-connections/{id}(SDKgetMcpConnection). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments mcp-connection revoke
Revoke an MCP connection.
deployments mcp-connection revoke <id>- Calls
DELETE /v1/mcp-connections/{id}(SDKrevokeMcpConnection). - Needs an environment:
--envor the saved context. - Destructive. Live runs ask for confirmation; pass
--yesin scripts or with--json. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--reason | string | Reason for this operation |
Also accepts the global flags.