Get MCP tool call volume histogram

Returns time-bucketed MCP tool call volume with success/error breakdown.

GET /api/mcp-logs/histogram

Error

A valid request URL is required to generate request examples

200

{
  "buckets": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "count": 123,
      "success": 123,
      "error": 123
    }
  ],
  "bucket_size_seconds": 123
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Query Parameters

tool_names · string

Comma-separated list of tool names to filter by

server_labels · string

Comma-separated list of server labels to filter by

status · string

Comma-separated list of statuses to filter by (processing, success, error)

virtual_key_ids · string

Comma-separated list of virtual key IDs to filter by

llm_request_ids · string

Comma-separated list of LLM request IDs to filter by

start_time · string<date-time>

Start time filter (RFC3339 format)

end_time · string<date-time>

End time filter (RFC3339 format)

min_latency · number

Minimum latency filter (milliseconds)

max_latency · number

Maximum latency filter (milliseconds)

content_search · string

Search in tool arguments and results

Response

200

application/json

MCP histogram retrieved successfully

Time-bucketed MCP tool call volume histogram

buckets · object[]

Show child attributes

bucket_size_seconds · integer<int64>