---
title: "corestack_deployments_company_variable_reveal"
url: https://docs.corefinity.com/mcp/tools/corestack_deployments_company_variable_reveal
type: tool
last_updated: 2026-11-13
feature: deployment-templates
related:
  - https://docs.corefinity.com/api/reference/deployments/reveal-company-deploy-variable.md
  - https://docs.corefinity.com/guides/sites/code-and-deployments/deployment-templates.md
---
# corestack_deployments_company_variable_reveal

**Show a company deployment variable.** Show the value of one of your company's deployment 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 your company's deployment 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. The reveal is recorded. This is the only way a stored company value is shown: the list never carries one. A token restricted to some sites cannot reveal company variables.

The same action in the public REST API, with the same checks, refusals and scope: `POST /api/corestack/companies/{company}/deploy-variables/{name}/reveal`. It answers the value to the token's own user, as `reveal_to_agent` does here.

## Inputs

- `name` (string, matching `^[A-Za-z_][A-Za-z0-9_]{0,63}$`, required): The variable's name from corestack_deployments_company_variables_list.
- `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": {
    "name": {
      "description": "The variable's name from corestack_deployments_company_variables_list.",
      "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
      "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": [
    "name"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role lacks the Edit Environment Deployment Pipeline permission, which showing a company
  variable's value needs, as setting one does; it is asked again when the person presses Show. The message names it and
  says an owner of the company can grant it in Roles; `details.permission` is `editEnvironmentDeploymentPipeline`.
  Nothing is shown.
- `not_available`: the stored value cannot be read; save it again with corestack_deployments_company_variable_set.
- 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_deployments_company_variable_reveal",
  "arguments": {
    "name": "SLACK_WEBHOOK"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployments_company_variable_reveal with name SLACK_WEBHOOK. (Show a company deployment variable.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/companies/{company}/deploy-variables/{name}/reveal](https://docs.corefinity.com/api/reference/deployments/reveal-company-deploy-variable.md)
- Guide: [Deployment templates](https://docs.corefinity.com/guides/sites/code-and-deployments/deployment-templates.md)
