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

**List a site's Varnish VCL revisions.** Lists a Magento 2 row's Varnish VCL revisions, newest first, with status and reason. Scope: read.

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

## When to use it

List a Magento 2 row's custom Varnish VCL revisions, newest first, 20 a page: each with its `number`, when it was saved, its author (and `mcp: true` when an MCP agent saved it), its `origin` (`save`, `revert` or `platform`), its `status` (`saving`, `pending_verify`, `applied`, `rejected`, `verify_failed`, `rolled_back`), whether it is the `current` one, the `hooks` it changed (against the revision it was saved on: the newest earlier one that stood, so a `rejected`, `verify_failed` or `rolled_back` revision in between is skipped), its note and its diagnostics count. A `rejected` or `rolled_back` revision carries the `reason`.

Read one revision with `corestack_varnish_vcl_revision_get`; put one back with `corestack_varnish_vcl_revert`.

## Inputs

- `site_id` (integer, ≥ 1, required): the row, a Magento 2 site or one of its environments.
- `cursor` (string, at most 200 characters): `next_cursor` from the previous page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "maxLength": 200,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

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

## Prompt

```text
Using the Corefinity MCP server, call corestack_varnish_vcl_history_list with site_id 4211. (List a site's Varnish VCL revisions.) Tell me what it returned.
```

## The same task elsewhere

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