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

**CoreCluster activity.** A CoreCluster's Activity feed — operations, commands, deployments, restores, snapshots, terminal sessions and PageSpeed runs on its sites, newest first. One site's feed on any kind of site is corestack_site_activity_list. Scope: read.

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

## When to use it

A CoreCluster's Activity feed — operations, commands, deployments, restores, snapshots, terminal sessions and PageSpeed runs on its sites, newest first. One site's feed on any kind of site is corestack_site_activity_list.

## Inputs

- `limit` (integer, 1–100): Items per page, 1–100 (25).
- `kinds` (array of one of `operation`, `command`, `deployment`, `restore`, `snapshot`, `terminal`, `pagespeed`, `audit`): Only these kinds of item.
- `unfinished` (boolean): Only work that has not finished.
- `before` (integer, 0–9999999999999999): The cursor: the last answer's next_before (send with before_id).
- `before_id` (string, up to 64 characters): The cursor: the last answer's next_before_id (send with before).
- `cluster_id` (integer, ≥ 1, required)
- `site_id` (integer, ≥ 1): Only this site or environment row of the cluster.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "before": {
      "description": "The cursor: the last answer's next_before (send with before_id).",
      "maximum": 10000000000000000,
      "minimum": 0,
      "type": "integer"
    },
    "before_id": {
      "description": "The cursor: the last answer's next_before_id (send with before).",
      "maxLength": 64,
      "type": "string"
    },
    "cluster_id": {
      "minimum": 1,
      "type": "integer"
    },
    "kinds": {
      "description": "Only these kinds of item.",
      "items": {
        "enum": [
          "operation",
          "command",
          "deployment",
          "restore",
          "snapshot",
          "terminal",
          "pagespeed",
          "audit",
          "copy"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "description": "Items per page, 1–100 (25).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "site_id": {
      "description": "Only this site or environment row of the cluster.",
      "minimum": 1,
      "type": "integer"
    },
    "unfinished": {
      "description": "Only work that has not finished.",
      "type": "boolean"
    }
  },
  "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_activity_list",
  "arguments": {
    "cluster_id": 812
  }
}
```

## Prompt

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

## The same task elsewhere

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