---
title: "Engagement"
method: GET
path: "/admin/engagement-buckets"
---

# Engagement

`GET /admin/engagement-buckets`

## Request

- Base URL: `https://api.local-mcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.local-mcp.com/admin/engagement-buckets`
- Auth: none declared. Required headers: `x-admin-key`

Bucket every alive machine (heartbeat ≤3d) by real tool usage: engaged (a tool call within
`days`), silent_abandonment (used tools once but not within `days`), never_used. Returns the
engaged retention % — the honest denominator vs heartbeat-alive.

## Query parameters

- `days` integer

## Headers

- `x-admin-key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/local-mcp/apis/lmcp-api.md) · [All operations](https://skmtc.dev/local-mcp/apis/lmcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/local-mcp/apis/lmcp-api/revisions/f1f1c502623a?raw)