Scopes
The default set of MCP scopes, the tools that need Destructive, and the calls that need more than one scope.
A scope says what a grant may do. The MCP server uses the API's four, read, write, exec and destructive: Scopes says what each allows.
Every tool's description names the scope it needs.
The default set
A new token and a first approval of an app have Read, Write and Exec ticked. Destructive is not ticked for you, even when the app asks for it.
Destructive lets the assistant delete production sites and clusters.
Destructive tools
These tools always need destructive:
corecluster_deletedeletes a cluster.corestack_site_deletedeletes a site.corestack_environment_deletedeletes an environment.corestack_snapshot_deletedeletes a backup.
Not every deletion is on this list. Some tools remove something for good with write, such as a role: read the scope in each tool's description.
Conditional scopes
Some calls need an extra scope, on top of the tool's own, when a condition holds.
| When the call | It also needs | Tools |
|---|---|---|
| Overwrites a production environment | destructive | corestack_site_clone, corestack_restore_create, corestack_snapshot_restore_to, corestack_db_import, corestack_site_rewrite_urls, corestack_site_rewrite_urls_restore |
Sets delete_extraneous on production | destructive | corestack_files_sync |
| Retries a site delete, an environment delete or a copy onto production | destructive | corestack_operation_retry |
Sets reveal_to_agent: true | exec | Every tool that can answer a secret: see Secrets |
| Asks for the download of a database export | exec | corestack_transfer_get |
| Reads or cancels a task | Every scope the call that started the task needed | corestack_task_get, corestack_task_cancel |
Node.js packages add one condition.
| When the call | It also needs | Tools |
|---|---|---|
| Turns Node.js install scripts on for a package | exec | corestack_node_packages_update, corestack_node_runtime_copy, corestack_site_clone |
A deployment pipeline adds one condition.
| When the call | It also needs | Tools |
|---|---|---|
| Saves a pipeline line that is not a preset | exec | corestack_, corestack_deployments_pipeline_copy, corestack_, corestack_, corestack_, corestack_ |
The server checks the whole set once, so a missing scope is asked for in one go.
When a scope is missing
| Grant | What happens |
|---|---|
| OAuth connection | The app reopens the approval page with the scopes the call needs ticked. Approve, and the app retries. |
| Personal token | The call answers scope_required with a link that opens Edit restrictions with the scope added. Save, then ask the assistant to retry. |
Adding a scope needs your two-factor code: see Sign in and tokens.