---
title: "Scopes"
url: https://docs.corefinity.com/mcp/scopes
type: page
last_updated: 2026-11-13
feature: mcp
---
# 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](/api/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.

> **Warning:** Destructive lets the assistant delete production sites and clusters.

## Destructive tools

These tools always need `destructive`:

- `corecluster_delete` deletes a cluster.
- `corestack_site_delete` deletes a site.
- `corestack_environment_delete` deletes an environment.
- `corestack_snapshot_delete` deletes 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](/mcp/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_deployments_pipeline_stage_update`, `corestack_deployments_pipeline_copy`, `corestack_deployments_carryover_accept`, `corestack_deployments_template_stage_update`, `corestack_deployments_template_environments_reset`, `corestack_deployments_pipeline_template_reset` |

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](/mcp/sign-in-and-tokens).
