---
title: "corestack_enterprise_variable_reveal"
url: https://docs.corefinity.com/mcp/tools/corestack_enterprise_variable_reveal
type: tool
last_updated: 2026-11-13
feature: enterprise-variables
related:
  - https://docs.corefinity.com/guides/corestack-enterprise/environment-variables.md
---
# corestack_enterprise_variable_reveal

**Show a CoreStack Enterprise build variable.** Show the value of one of a CoreStack Enterprise environment's build variables — in the person's browser by default. 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 the value of one of a CoreStack Enterprise environment's build variables. By default it opens in the person's
browser on a secret page, and nothing is read until they press Show. Only with exec and `reveal_to_agent: true` is the
value returned to you, as `{name, value}`. A cleared variable's value is `""`. The reveal is recorded. This is the only
way a stored value is shown: the variables list and the set's answer never carry one. For a CoreStack or CoreCluster
site, use `corestack_deployments_variable_reveal` by `site_id` instead.

The public API's `POST /api/environments/{environment}/variables/{name}/reveal` answers the value to the token's own
user, as `reveal_to_agent` does here; both share the credentials budget of 10 reveals a minute.

## Inputs

- `enterprise_env_id` (integer, ≥ 1, required)
- `name` (string, required): the variable's name from `corestack_enterprise_variables_list`, as it was saved. A variable
  saved before today's name rules (with a hyphen, say) can still be shown by that name.
- `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": {
    "enterprise_env_id": {
      "description": "A CoreStack Enterprise environment's id; for CoreStack or CoreCluster use the corestack_deployment_* tools.",
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "description": "The variable's name from corestack_enterprise_variables_list.",
      "type": "string"
    },
    "reveal_to_agent": {
      "default": false,
      "description": "Return the secret to you instead of opening it in the person's browser. Needs exec.",
      "type": "boolean"
    }
  },
  "required": [
    "enterprise_env_id",
    "name"
  ],
  "type": "object"
}
```

## Refusals

- `not_available` (409): the stored value can no longer be read ("This value can no longer be read. Set it again."); set
  it again with `corestack_enterprise_variable_set`.
- `rate_limited`: more than 10 reveals in a minute.
- `invalid_arguments` (field `enterprise_env_id`): a CoreStack or CoreCluster environment; use the
  `corestack_deployments_*` tools by `site_id`.
- `tenant_mismatch` ("Not found."): the environment does not exist, is not the person's, or is hidden from them; and a
  name the environment has no variable of, before any link is offered. Both answers are the same, so read
  `corestack_enterprise_variables_list` to tell them apart.
- `pin_refused`, and the refusals every tool can answer: `scope_required`, `temporarily_unavailable`, `internal_error`
  (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_enterprise_variable_reveal",
  "arguments": {
    "enterprise_env_id": 1530,
    "name": "API_TOKEN"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_enterprise_variable_reveal with enterprise_env_id 1530, name API_TOKEN. (Show a CoreStack Enterprise build variable.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Environment variables](https://docs.corefinity.com/guides/corestack-enterprise/environment-variables.md)
