---
title: "corestack_varnish_vcl_revision_get"
url: https://docs.corefinity.com/mcp/tools/corestack_varnish_vcl_revision_get
type: tool
last_updated: 2026-11-13
feature: varnish
related:
  - https://docs.corefinity.com/api/reference/varnish/get-site-varnish-vcl-revision.md
  - https://docs.corefinity.com/guides/sites/software-and-services/varnish.md
---
# corestack_varnish_vcl_revision_get

**Show one Varnish VCL revision.** Shows one Varnish VCL revision by number, with a diff against the VCL now or another revision. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Read one custom Varnish VCL revision of a Magento 2 row by its number: the three hooks' text, its status, the reason a rejected or rolled-back revision carries and its diagnostics, with a line diff against the VCL now (the default) or against another revision.

## Inputs

- `site_id` (integer, ≥ 1, required): the row, a Magento 2 site or one of its environments.
- `number` (integer, ≥ 0, required): the revision number from `corestack_varnish_vcl_history_list`. Revision 0 is the platform's original: the empty hooks every site starts with.
- `against` (string, default `current`): `current`, or another revision's number (such as `"3"`, or `"0"` for the original) to diff against.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "against": {
      "default": "current",
      "description": "current or a revision number.",
      "maxLength": 12,
      "type": "string"
    },
    "number": {
      "description": "0 is the platform's original.",
      "minimum": 0,
      "type": "integer"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "number"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: the row has no revision with that number (or the row is not yours).
- `varnish_not_offered`: the row is not a Magento 2 site.
- 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_varnish_vcl_revision_get",
  "arguments": {
    "site_id": 4211,
    "number": 3
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_varnish_vcl_revision_get with site_id 4211, number 3. (Show one Varnish VCL revision.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/varnish/vcl/revisions/{number}](https://docs.corefinity.com/api/reference/varnish/get-site-varnish-vcl-revision.md)
- Guide: [Varnish](https://docs.corefinity.com/guides/sites/software-and-services/varnish.md)
