Confirmations
The confirm values that guard destructive and billable MCP calls, and what an assistant must do before sending one.
Most tools that delete something, overwrite production or spend money take a confirm_* argument. Not every one does, deleting a backup for example: a tool's schema lists the arguments it takes.
What the assistant must do
- Say exactly what will happen. Use the tool's preview or dry run first where it has one.
- Wait for the person to agree to that exact action.
- Only then send the
confirm_*value.
The server never pauses to ask: the value is the confirmation.
A mismatch
A wrong typed value answers confirm_mismatch and names the field. Nothing was changed.
{
"error": {
"reason": "confirm_mismatch",
"message": "Type the environment's name exactly to confirm",
"field": "confirm_name"
}
}A missing value
What a call without the value answers depends on the tool. Each tool's reference page says which fields it requires.
- A field the tool requires, as
confirm_nameis oncorestack_team_role_delete: the call answersinvalid_arguments, and nothing was changed. - A field needed only for some calls, as
confirm_agencyis oncorestack_company_agency_detach: the call is refused with the tool's own reason, such asconfirm_mismatchwith the value to send, and nothing was changed. - An optional field, which
confirm_usernameis oncorestack_ssh_user_delete, andconfirm_fingerprintoncorestack_ssh_user_key_delete,corestack_company_ssh_key_updateandcorestack_company_ssh_key_delete: the call goes ahead, and the value is checked only when it is sent.
Typed values
Each of these must match exactly. A value is text unless its entry names another type, and the type matters: a number sent as text, or text sent where a list is expected, answers invalid_arguments.
confirm_domain: the site's domain. Guards deleting a site; changing its package or URL; attaching a domain; overwriting it with a copy, restore, import or file sync.confirm_name: the object's name. Guards deleting a cluster, environment, role or performance audit; changing a cluster's package.confirm_count,confirm_targets: the number the call acts on, as a whole number, or the production site ids, as a list of whole numbers. Guards starting a performance audit's tests; deployment template changes.confirm_email: the user's email address. Guards removing a user.confirm_agency,confirm_client,confirm_connection: the same id again, as a whole number. Guards detaching an agency or a client; deleting a repository connection.confirm_delete: the same id again, as text. Guards deleting a registry secret.confirm_target_site: the target site's name, from the preview. Guards copying a CoreStack Enterprise environment into a site.confirm_fingerprint: the SSH key'sSHA256:fingerprint. Guards changing or removing an SSH key.confirm_username: the SSH user's username. Guards deleting an SSH user.confirm_environment: the environment's name. Guards rotating SSH host keys.confirm_address,confirm_preset: the entry's address, such as203.0.113.7/32, or the preset's slug. Guards removing a firewall entry or preset.confirm_labels: a list of text values, the label of each scheduled task being removed. Guards updating scheduled tasks.confirm_read_write: the textread-write. Guards giving an external database user write access.confirm_environment: the environment's name. Guards turning external database access off.confirm_company: the organisation's name. Guards deleting Marketplace keys that sites still use.confirm_keep,confirm_billing_country: the site's domain or the wordcluster; the two-letter billing country. Guards keeping a demo.
Yes-or-no values
Each of these takes true, once the person has agreed.
confirm_production: copying settings or a pipeline onto production.confirm_cost: a change that adds to the monthly price.confirm_emergency: raising a support ticket as an emergency.confirm_older: retrying an older deployment.confirm_off: turning a site's platform plugins off.confirm_remove_repositories: moving a CoreStack Enterprise environment off Git.confirm: applying pending changes now; running a platform tool; resetting an administrator login.confirm_replacements: replacing DNS records that already exist.confirm_spend: turning automatic upgrades on, or raising their limit.
Each tool's reference page lists the fields it takes. Confirmations are checked after scopes and pins.