Secrets
How passwords and logins reach you instead of the assistant, and what reveal_to_agent changes.
On this page
When a tool would answer a secret the Control Panel holds, the secret goes to you, not to the assistant. The assistant gets a link to a page in the Control Panel, and you open it in your browser.
This covers:
- database credentials, and database user passwords;
- administrator logins, including the first login of a new site, login resets and one-time login links;
- password protection logins and preview logins;
- generated SSH passwords;
- deployment variable values;
- browser terminal recordings;
- a performance audit's share link.
The secret page
- The assistant calls the tool. Your client opens the link, or the assistant shows it to you.
- Sign in to the Control Panel, with your two-factor code.
- Choose Show to see the secret, or Don't show to decline.
| Rule | Value |
|---|---|
| Link lifetime | 15 minutes |
| Uses | One |
| Who can open it | Only the person whose token or app made the call |
A tool that resets a login, creates an administrator or sets an SSH password changes nothing until you choose the button, which then reads Reset and show, Create and show or Set and show.
Give a secret to the assistant
The assistant receives the value only when both are true:
- the grant holds the
execscope; - the call sets
reveal_to_agent: true.
{
"name": "corestack_db_credentials_get",
"arguments": {
"site_id": 1042,
"reveal_to_agent": true
}
}An assistant should set it only when you ask for the value to be given to it. The value is then in the tool result only: it is never stored in the activity log.
One-time logins
A new site's administrator login can be shown once, to whoever reveals it first, in the Control Panel or through MCP. After that the call answers already_revealed, and the assistant can offer a reset with corestack_admin_login_reset.
Values that are never returned
Some values go in and never come back, such as a deployment registry token. Their read tools answer whether a value is set and its last four characters.
What is not a secret
Site files and command output are not hidden. A grant with read can read any file in a site, including configuration files that hold passwords.
Limit a grant and Safety say how to narrow that.