---
title: "corestack_logs_usage_get"
url: https://docs.corefinity.com/mcp/tools/corestack_logs_usage_get
type: tool
last_updated: 2026-11-13
feature: logs
related:
  - https://docs.corefinity.com/api/reference/logs/get-site-log-usage.md
  - https://docs.corefinity.com/guides/sites/logs-and-monitoring/logs.md
---
# corestack_logs_usage_get

**Site logs usage.** How much log storage a site uses against its quota, how long its logs are kept, and the forecast. Raise the quota with corestack_site_addons_set (log_storage_gb). Scope: read.

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

## When to use it

How much log storage a site uses against its quota, how long its logs are kept, and the forecast. Raise the quota with corestack_site_addons_set (log_storage_gb).

## Inputs

- `site_id` (integer, ≥ 1, required)

### Input schema

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

## Refusals

- `logs_not_collected`: logs are not collected for this source; nothing to read.
- 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_logs_usage_get",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_logs_usage_get with site_id 4211. (Site logs usage.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/logs/usage](https://docs.corefinity.com/api/reference/logs/get-site-log-usage.md)
- Guide: [Logs](https://docs.corefinity.com/guides/sites/logs-and-monitoring/logs.md)
