---
title: "corestack_http_auth_reveal_password"
url: https://docs.corefinity.com/mcp/tools/corestack_http_auth_reveal_password
type: tool
last_updated: 2026-11-13
feature: http-auth
related:
  - https://docs.corefinity.com/api/reference/access/reveal-site-http-auth-password.md
  - https://docs.corefinity.com/guides/sites/access-and-security/password-protection.md
---
# corestack_http_auth_reveal_password

**Show an HTTP-auth password.** Show the password of one HTTP authentication login — in the person's browser by default. The reveal is recorded on the login. 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 the password of one HTTP authentication login — in the person's browser by default. The reveal is recorded on the login.

## Inputs

- `site_id` (integer, ≥ 1, required): The row the login protects.
- `user_id` (integer, ≥ 1, required): The login's id from corestack_http_auth_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": {
      "description": "The row the login protects.",
      "minimum": 1,
      "type": "integer"
    },
    "user_id": {
      "description": "The login's id from corestack_http_auth_get.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "user_id"
  ],
  "type": "object"
}
```

## Refusals

- `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_http_auth_reveal_password",
  "arguments": {
    "site_id": 4211,
    "user_id": 5021
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_http_auth_reveal_password with site_id 4211, user_id 5021. (Show an HTTP-auth password.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/http-auth/users/{user}/reveal](https://docs.corefinity.com/api/reference/access/reveal-site-http-auth-password.md)
- Guide: [Password protection](https://docs.corefinity.com/guides/sites/access-and-security/password-protection.md)
