SecureAuth Agent Authority
secureauth.com
Request demoFree trial
APIAnalytics

MCP connect failure time series

Agent sessions that could not reach an MCP over time, counted once per MCP. Sessions of organization-owned agents on MCPs that need a user are left out.

GET
/analytics/mcp-connect-failures-over-time

Agent sessions that could not reach an MCP over time, counted once per MCP. Sessions of organization-owned agents on MCPs that need a user are left out.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_tool_analytics

Query Parameters

scope?string

own returns only the caller's own records, even when they may see the whole organization. all, the default, returns everything the caller may see. It never widens what the caller may see.

Value in"all""own"
start_time*string

Start of the time range to report on, inclusive.

Formatdate-time
end_time*string

End of the time range to report on, exclusive.

Formatdate-time
interval?string

Time bucket size for the series: hour or day.

Value in"hour""day"
mcp_id?array<>

Filter to specific MCP servers by id.

user_id?array<>

Filter to specific users by id.

Response Body

The request has succeeded.

application/json
  1. response

Time-bucketed event counts.

series*array<>

Ordered data points, one per time bucket.

Example Request
curl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/analytics/mcp-connect-failures-over-time?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z'
Example Response
{  "series": [    {      "timestamp": "2019-08-24T14:15:22Z",      "count": 0    }  ]}

LLM user percentiles GET

Usage percentile per gateway-attributed user with usage in the range, ranked by total tokens. A percentile of 0.25 or above is what the team adoption views count as a seat in use. Filters are limited to provider and user_group, and each user's groups come back narrowed to the selected ones. Bounded rather than paged: the heaviest 500 users are returned in one response and no page params are accepted. Percentiles are always computed over the whole population, so meta.total is the real headcount and exceeds items.length exactly when the response is a sample.

Tool access by hour GET

Tool and write calls by hour of day (UTC).