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

**Where a deployment template is used.** Every environment a deployment template reaches: per stage whether it follows the template or holds its own, its last deployment and what changed since. Filter by role, stage, state or a search. Scope: read.

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

## When to use it

See every environment a deployment template reaches: per stage whether it follows the template, holds its own content or is replaced below, its last deployment and what was written since, and any company variables it lacks. Filter by `role`, `stage`, `state` or a search; a token limited to some sites sees only those.

The same action in the public REST API, with the same checks, refusals and scope: `GET /api/corestack/companies/{company}/deploy-templates/{platform}/usage`.

## Inputs

- `platform` (string, required)
- `role` (string, one of `production`, `uat`)
- `stage` (string, one of `build`, `database`, `post_deploy`, `settings`)
- `state` (string, one of `follows_every_stage`, `overrides_some`, `overrides_every_stage`, `replaced_below`, `changed_since_deploy`, `kept`, `relink_pending`)
- `q` (string, up to 100 characters): A domain or environment name to search for.
- `cursor` (integer, 0 to 999999): next_cursor of the page before.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "next_cursor of the page before.",
      "maximum": 999999,
      "minimum": 0,
      "type": "integer"
    },
    "platform": {
      "enum": [
        "magento2",
        "laravel",
        "wordpress",
        "shopware5"
      ],
      "type": "string"
    },
    "q": {
      "description": "A domain or environment name to search for.",
      "maxLength": 100,
      "type": "string"
    },
    "role": {
      "enum": [
        "production",
        "uat"
      ],
      "type": "string"
    },
    "stage": {
      "enum": [
        "build",
        "database",
        "post_deploy",
        "settings"
      ],
      "type": "string"
    },
    "state": {
      "enum": [
        "follows_every_stage",
        "overrides_some",
        "overrides_every_stage",
        "replaced_below",
        "changed_since_deploy",
        "kept",
        "relink_pending"
      ],
      "type": "string"
    }
  },
  "required": [
    "platform"
  ],
  "type": "object"
}
```

## Refusals

- 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_template_usage_list",
  "arguments": {
    "platform": "magento2",
    "state": "overrides_some"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployments_template_usage_list with platform magento2, state overrides_some. (Where a deployment template is used.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/companies/{company}/deploy-templates/{platform}/usage](https://docs.corefinity.com/api/reference/deployments/list-deploy-template-usage.md)
- Guide: [Deployment templates](https://docs.corefinity.com/guides/sites/code-and-deployments/deployment-templates.md)
