Docs: Tool reference
audit toolset

get_usage

Get usage and performance. Shows how the workspace is being used through CareChannel's API: calls, errors and latency in total, by surface (web, REST, MCP) and by tool; which MCP clients and API keys act here and for whom, with when they were last seen; and whether the latency and availability objectives are met. range: last_24_hours, last_7_days (default) or last_30_days. Latency is estimated from buckets. Owners only. No side effects.

Toolset
audit
Who can call it
Owners
REST
GET /api/v1/w/{workspace}/usage
Behavior
read-onlyidempotent

Input

FieldTypeDescription
rangeone of: last_24_hours, last_7_days, last_30_days Default: "last_7_days".

Output

FieldTypeDescription
admin_urlrequiredstring (uri)The Usage page in the admin.
rangerequiredobject
totalsrequiredobject
by_surfacerequiredarray of object
slosrequiredarray of object
clientsrequiredarray of objectWho called through REST and MCP, most recent first (the web app is one row).
toolsrequiredarray of objectMost-called tools first, at most 50.

Calling it

// MCP: tools/call
{ "name": "get_usage", "arguments": {} }

// Typed client
await carechannel.get_usage({});