Deployments.ai Docs
Command reference

deployments mcp-connection

MCP runtime connections

CommandSummary
deployments mcp-connection createCreate an MCP connection
deployments mcp-connection listList MCP connections
deployments mcp-connection showShow an MCP connection
deployments mcp-connection revokeRevoke an MCP connection

deployments mcp-connection create

Create an MCP connection.

deployments mcp-connection create --server <server>
  • Calls POST /v1/mcp-connections (SDK createMcpConnection).
  • Needs an environment: --env or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
--serverstringyesMCP server ID

Also accepts the global flags.

deployments mcp-connection list

List MCP connections.

deployments mcp-connection list
  • Calls GET /v1/mcp-connections (SDK listMcpConnections).
  • Needs an environment: --env or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size

Also accepts the global flags.

deployments mcp-connection show

Show an MCP connection.

deployments mcp-connection show <id>
FlagTypeRequiredDefaultDescription
<id>positionalyesResource 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} (SDK revokeMcpConnection).
  • Needs an environment: --env or the saved context.
  • Destructive. Live runs ask for confirmation; pass --yes in scripts or with --json.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID
--reasonstringReason for this operation

Also accepts the global flags.

On this page