---
title: "corecluster_usage_get"
url: https://docs.corefinity.com/mcp/tools/corecluster_usage_get
type: tool
last_updated: 2026-11-13
feature: clusters
related:
  - https://docs.corefinity.com/api/reference/corecluster/get-cluster-usage.md
  - https://docs.corefinity.com/guides/corecluster/cluster-overview.md
---
# corecluster_usage_get

**CoreCluster usage.** A CoreCluster's CPU, memory and disk use over the last 6 hours, 24 hours, 7 days or 30 days. Scope: read.

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

## When to use it

A CoreCluster's CPU, memory and disk use over the last 6 hours, 24 hours, 7 days or 30 days.

## Inputs

- `cluster_id` (integer, ≥ 1, required)
- `range` (one of `6h`, `24h`, `7d`, `30d`): 6h, 24h (the default), 7d or 30d.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cluster_id": {
      "minimum": 1,
      "type": "integer"
    },
    "range": {
      "description": "6h, 24h (the default), 7d or 30d.",
      "enum": [
        "6h",
        "24h",
        "7d",
        "30d"
      ],
      "type": "string"
    }
  },
  "required": [
    "cluster_id"
  ],
  "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": "corecluster_usage_get",
  "arguments": {
    "cluster_id": 812
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corecluster_usage_get with cluster_id 812. (CoreCluster usage.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/clusters/{cluster}/usage](https://docs.corefinity.com/api/reference/corecluster/get-cluster-usage.md)
- Guide: [Cluster overview](https://docs.corefinity.com/guides/corecluster/cluster-overview.md)
