Command reference
deployments extension
Custom MCP and callback tools
| Command | Summary |
|---|---|
deployments extension create | Register an extension tool |
deployments extension list | List extension tools |
deployments extension show | Show an extension tool |
deployments extension update | Update an extension tool |
deployments extension archive | Archive an extension tool |
deployments extension create
Register an extension tool.
deployments extension create --name <name> --description <description> --effect <effect> --execution <json> --input-schema <json> --scopes <json> --default-action <default-action>- Calls
POST /v1/extensions(SDKcreateExtensionTool). - 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 | |
--description | string | yes | Extension tool description | |
--effect | string | yes | read, write, or execute | |
--execution | string (json) | yes | MCP or callback execution binding | |
--input-schema | string (json) | yes | JSON input schema | |
--provider | string | Provider key | ||
--scopes | string (json) | yes | Required scopes | |
--default-action | string | yes | allow, require_approval, or deny | |
--callback-secret | string | Callback bearer secret (prefer env or file source) | ||
--callback-secret-env | string | Environment variable containing the callback bearer secret | ||
--callback-secret-file | string | File containing the callback bearer secret |
Also accepts the global flags.
deployments extension list
List extension tools.
deployments extension list- Calls
GET /v1/extensions(SDKlistExtensionTools). - 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 extension show
Show an extension tool.
deployments extension show --name <name>- Calls
GET /v1/extensions/{toolName}(SDKgetExtensionTool). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--name | string | yes | Tool name |
Also accepts the global flags.
deployments extension update
Update an extension tool.
deployments extension update --name <name> --expected-version <number>- Calls
PATCH /v1/extensions/{toolName}(SDKupdateExtensionTool). - 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 | Tool name | |
--expected-version | string (number) | yes | Expected resource version | |
--description | string | Resource description | ||
--effect | string | read, write, or execute | ||
--execution | string (json) | MCP or callback execution binding | ||
--input-schema | string (json) | JSON input schema | ||
--provider | string | Provider key | ||
--scopes | string (json) | Required scopes | ||
--default-action | string | allow, require_approval, or deny | ||
--callback-secret | string | Replacement callback bearer secret (prefer env or file source) | ||
--callback-secret-env | string | Environment variable containing the replacement callback bearer secret | ||
--callback-secret-file | string | File containing the replacement callback bearer secret |
Also accepts the global flags.
deployments extension archive
Archive an extension tool.
deployments extension archive --name <name>- Calls
DELETE /v1/extensions/{toolName}(SDKarchiveExtensionTool). - 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 |
|---|---|---|---|---|
--name | string | yes | Tool name |
Also accepts the global flags.