---
title: "corestack_site_provisioning_reveal"
url: https://docs.corefinity.com/mcp/tools/corestack_site_provisioning_reveal
type: tool
last_updated: 2026-11-13
feature: site-create
related:
  - https://docs.corefinity.com/api/reference/sites/reveal-site-install-login.md
  - https://docs.corefinity.com/guides/sites/create-and-manage/create-a-site.md
---
# corestack_site_provisioning_reveal

**Show the install login.** Show a fresh install's admin login once (WordPress, Magento 2). Whoever reveals it first, here or in the control panel, is the only one who sees it; afterwards reset it with corestack_admin_login_reset. 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 fresh install's admin login once (WordPress, Magento 2). Whoever reveals it first, here or in the Control Panel, is the only one who sees it; afterwards reset it with corestack_admin_login_reset.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `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"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `provisioning`: the site is still being created; wait for corestack_site_provisioning_get to finish.
- `already_revealed`: a one-time secret was already shown; `details.revealed` = `{"at", "by_name", "via": "panel" \; offer the reset (with `reset_target.username`, or ask the person which administrator when it is null).
- `busy`: another change is running on this row; wait for it (corestack_site_operation_get) and call again.
- `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_site_provisioning_reveal",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_provisioning_reveal with site_id 4211. (Show the install login.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/provisioning/reveal](https://docs.corefinity.com/api/reference/sites/reveal-site-install-login.md)
- Guide: [Create a site](https://docs.corefinity.com/guides/sites/create-and-manage/create-a-site.md)
