---
title: "Secrets"
url: https://docs.corefinity.com/mcp/secrets
type: page
last_updated: 2026-11-13
feature: mcp
---
# Secrets

How passwords and logins reach you instead of the assistant, and what reveal_to_agent changes.

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

1. The assistant calls the tool. Your client opens the link, or the assistant shows it to you.
2. Sign in to the Control Panel, with your two-factor code.
3. 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 `exec` scope;
- the call sets `reveal_to_agent: true`.

```json
{
  "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

> **Warning:** 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](/mcp/limit-a-grant) and [Safety](/mcp/safety) say how to narrow that.
