---
title: "corestack_external_db_user_password_reveal"
url: https://docs.corefinity.com/mcp/tools/corestack_external_db_user_password_reveal
type: tool
last_updated: 2026-11-13
feature: database
related:
  - https://docs.corefinity.com/api/reference/database/reveal-site-database-user-password.md
  - https://docs.corefinity.com/guides/sites/database/database-users.md
---
# corestack_external_db_user_password_reveal

**Show a database user's new password.** Show a database user's generated password once, in the person's browser by default. Only a password the control panel generated in the last 24 hours and not shown yet can be shown; the reveal is recorded. Scope: exec. The secret opens in the person's browser; set reveal_to_agent to true to receive it yourself (needs exec).

- Scope: `exec`
- Runs as a task: no
- Returns a secret only when `reveal_to_agent` is set

## When to use it

Show a database user's generated password once more after the add or the rotation that made it, when the person did not open it then. It can be shown once only, within 24 hours of being made: the Control Panel keeps only the password's hash after that. The reveal is recorded in the environment's Activity.

By default the password opens in the person's browser, and nothing is read until they press Show. It is given to you only with exec and `reveal_to_agent: true`, when the person asked for that.

A password you set yourself is never stored, so there is nothing to show: rotate it with corestack_external_db_user_password_rotate instead. The site's own `application` login is shown by corestack_db_credentials_get.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `username` (string, required): the user's name from corestack_external_db_get.
- `reveal_to_agent` (boolean, default `false`): Return the secret to you instead of opening it in the person's browser. Needs exec.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "reveal_to_agent": {
      "default": false,
      "description": "Return the secret to you instead of opening it in the person's browser. Needs exec.",
      "type": "boolean"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "username": {
      "maxLength": 128,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "site_id",
    "username"
  ],
  "type": "object"
}
```

## Refusals

- `reveal_gone`: nothing to show: the password was shown already, was set by hand, is more than 24 hours old, or its change has not finished. Rotate it for a new one.
- `user_not_found`: no user of that name on this environment.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_external_db_user_password_reveal",
  "arguments": {
    "site_id": 4211,
    "username": "reporting_ro"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_external_db_user_password_reveal with site_id 4211, username reporting_ro. (Show a database user's new password.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/database/users/{username}/reveal](https://docs.corefinity.com/api/reference/database/reveal-site-database-user-password.md)
- Guide: [Database users](https://docs.corefinity.com/guides/sites/database/database-users.md)
