Command reference
deployments mcp-server
Remote MCP servers
| Command | Summary |
|---|---|
deployments mcp-server create | Register an MCP server |
deployments mcp-server list | List MCP servers |
deployments mcp-server show | Show an MCP server |
deployments mcp-server update | Update an MCP server |
deployments mcp-server discover | Verify and discover MCP tools |
deployments mcp-server archive | Archive an MCP server |
deployments mcp-server create
Register an MCP server.
deployments mcp-server create --name <name> --endpoint-origin <endpoint-origin> --endpoint-path <endpoint-path> --tools <json>- Calls
POST /v1/mcp-servers(SDKcreateMcpServer). - 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 |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--endpoint-origin | string | yes | HTTPS endpoint origin | |
--endpoint-path | string | yes | Endpoint path | |
--tools | string (json) | yes | Remote tool allowlist | |
--auth | string | MCP authentication JSON (prefer env or file source) | ||
--auth-env | string | Environment variable containing MCP authentication JSON | ||
--auth-file | string | File containing MCP authentication JSON |
Also accepts the global flags.
deployments mcp-server list
List MCP servers.
deployments mcp-server list- Calls
GET /v1/mcp-servers(SDKlistMcpServers). - 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-server show
Show an MCP server.
deployments mcp-server show <id>- Calls
GET /v1/mcp-servers/{id}(SDKgetMcpServer). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments mcp-server update
Update an MCP server.
deployments mcp-server update <id> --expected-version <number>- Calls
PATCH /v1/mcp-servers/{id}(SDKupdateMcpServer). - 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 |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--expected-version | string (number) | yes | Expected resource version | |
--name | string | New server name | ||
--endpoint-origin | string | New HTTPS endpoint origin | ||
--endpoint-path | string | New endpoint path | ||
--tools | string (json) | Remote tool allowlist | ||
--auth | string | Replacement MCP authentication JSON (prefer env or file source) | ||
--auth-env | string | Environment variable containing replacement MCP authentication JSON | ||
--auth-file | string | File containing replacement MCP authentication JSON |
Also accepts the global flags.
deployments mcp-server discover
Verify and discover MCP tools.
deployments mcp-server discover <id>- Calls
POST /v1/mcp-servers/{id}/discover(SDKdiscoverMcpServer). - 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 |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments mcp-server archive
Archive an MCP server.
deployments mcp-server archive <id>- Calls
DELETE /v1/mcp-servers/{id}(SDKarchiveMcpServer). - 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.