---
title: "Admin Connected Agents"
method: GET
path: "/admin/connected-agents"
---

# Admin Connected Agents

`GET /admin/connected-agents`

## 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/connected-agents`
- Auth: none declared. Required headers: `x-admin-key`

Which AI agents users actually have connected, unified across the three
surfaces (none of which existed in one place before):
  • desktop  — local stdio clients (Claude Desktop, Cursor, VS Code, CLI…) from heartbeats (7d)
  • web_oauth — cloud web AIs that bound via OAuth (ChatGPT, Claude.ai) — live grants
  • web_url  — cloud web AIs that bound via ?token= in the URL (Grok, Claude.ai)
Test/probe identities are excluded. Counts are distinct machines (desktop) or
distinct tokens (web = distinct user installs).

`hours` (default 720 = 30d) filters the time-windowed surfaces — web_url, the
Discovery panel, and the cloud→install conversion — so you can zoom into a recent
window (e.g. ?hours=1 / 6 / 24) to diagnose a spike. desktop (7d heartbeat) and
web_oauth (live grants) are not time-windowed.

## Query parameters

- `hours` 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)