Skip to content

diagnostics

DiagnosticsRead-only

The app's own health, for debugging it.

Available at every access level, including a client that sent X-Access-Level: readonly.

Parameters

NameTypeRequiredDescription
actionstring one of "memory", "log", "clients"yesWhat to do. memory: Managed heap, RSS, GC and cache sizes. (force_gc) log: The newest lines of the app's log. Entries that name anything in a hidden folder are left out, and counted in left_out_hidden. (lines) clients: The MCP clients seen since SuperCapture started, most recent first: name, version, transport, toolsets, when it started and was last seen, calls made, and whether it has ended. Never a session id or a token.
force_gcbooleannomemory: collect first and report what was reclaimed.
linesintegernolog: how many of the newest lines (default 100).

Example

A JSON-RPC call to POST http://localhost:21516/mcp with the bearer token, filling in the required parameters:

{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "diagnostics",
"arguments": {
"action": "memory"
}
}
}

See the MCP server overview for how to connect a client and where the token lives.