Skip to main content

Analytics and audit API

Read tool-call analytics for your organization's MCPs and the audit trail of configuration changes. Every operation on this page needs the read scope. Try the reports with your own key in the MCP Management API playground.

Reports​

Reports cover tool calls made through the gateway you call, for your organization.

ReportDefault rangeMax rangeGroup by (up to 2)Filters
GET /usage7 days92 daysmcp, tool, user, agent, called_via, auth_mode, transport, outcomeSame as group by
GET /mcps/{mcp_id}/usage7 days92 daysAs /usage, restricted to one MCPAs /usage
GET /latency7 days92 daysmcp, tool, transport, outcomeAs /usage
GET /dlp/summary7 days92 daysmcp, tool, user, category, directionSame as group by
GET /requests24 hours31 daysNonemcp, tool, user, agent, called_via, auth_mode, transport, outcome, blocked, request_id
GET /users30 days92 daysNonemcp, tool, user, agent, called_via, auth_mode, transport, outcome
  • /usage returns tool calls, outcomes, unique users and tools, durations and payload sizes per period and dimension, with totals of the whole selection.
  • /latency returns duration percentiles (p50, p90, p95, p99), average, maximum and a fixed-edge histogram.
  • /dlp/summary returns per-request DLP totals by direction (scanned, flagged, blocked). Per-category detection counts are reported separately and never inflate request totals.
  • /requests returns tool-call metadata, newest first: MCP, tool, user, agent, outcome, duration and DLP outcome. It never returns tool arguments, responses, error text, headers or tokens.
  • /users returns calls, successes, errors, blocked calls, MCPs and tools used, and first and last seen, per user. Calls without a recorded user are one row with user null.

For full tool-call logs in your own data platform, use the Log Export API.

Report parameters​

ParameterRule
from, tofrom is inclusive and to exclusive. RFC 3339 times with a timezone, or dates: from is UTC midnight and to runs through the end of that UTC day.
granularitytotal (default), month, week, day or hour. hour covers at most 14 days. Periods start on UTC boundaries.
group_byUp to two dimensions from the table above, comma-separated in one parameter (group_by=mcp,tool). Repeating group_by is 400.
FiltersComma-separated values, at most 50, each at most 320 characters.
outcomeblocked (DLP or policy block), else error, else success.
sort, limit, cursorAggregate reports return up to 5,000 rows per page (default 500); /requests and /users up to 1,000 (default 100).

Report errors​

ResponseWhat to do
400 invalid_requestA parameter is invalid. error.fields is an object keyed by query parameter with the reason, for example {"to": "must be after from"}.
429 report_busyRetry after Retry-After.
503 query_timeoutNarrow the range or filters and retry.
422 result_too_largeThe report would exceed 100,000 rows. Narrow it.
503 data_unavailableAnalytics data cannot be read right now. Retry later. On a deployment without an analytics store it is permanent, and the message says analytics is not available on this deployment: do not retry.
409 collection_changedA cursor's result changed. Restart without a cursor. A fixed to in the past keeps results stable.

Audit​

GET /audit lists your organization's configuration changes, newest first, whether made in the Quilr console (via: "ui") or through this API (via: "management_api", with management_key_id).

Each event has event_id, created_at, actor_email, actor_role, action, resource_type, resource_id, resource_name, changed_fields (when recorded), result, request_id and operation_id. Before and after values are never returned. action and resource_type are the same identifiers the console audit page shows.

FilterRule
actorEmail, case-insensitive.
action, resource_type, resource_idExact values.
viaui or management_api.
since, untilsince inclusive, until exclusive; RFC 3339 with a timezone.

Paging uses limit (1 to 200, default 50) and cursor. New events never invalidate a cursor.

curl "$GW/mcpgateway/management/v1/audit?via=management_api&since=2026-11-01T00:00:00Z" \
--header "Authorization: Bearer $KEY"

Endpoint reference​

GET/dlp/summary

DLP summary

Per-request DLP totals by direction (scanned, flagged, blocked) and, reported separately so they never inflate request totals, per-category detection counts.

REQUIRESread
Path, query & header parameters 12
from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: UTC midnight 7 days before `to`. At most 92 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

granularity (query)stringoptional

Period of each row: total (default), month, week, day or hour (hour covers at most 14 days). Periods start on UTC boundaries.

"total""month""week""day""hour"
group_by (query)stringoptional

Up to two comma-separated dimensions: mcp, tool, user, category, direction.

mcp (query)stringoptional

Comma-separated values (at most 50); matches any. MCP ids.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

category (query)stringoptional

Comma-separated values (at most 50); matches any. Exact category values.

direction (query)stringoptional

Comma-separated values (at most 50); matches any. input or output.

sort (query)stringoptional

Row order: period, requests, flagged, blocked.

"period""requests""flagged""blocked"
limit (query)integeroptional

Rows per page, 1 to 5000 (default 500).

min: 1max: 5000default: 500
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/dlp/summary?limit=500' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/latency

Latency report

Call duration percentiles (p50, p90, p95, p99), average, maximum and a fixed-edge histogram per period and dimension.

REQUIRESread
Path, query & header parameters 15
from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: UTC midnight 7 days before `to`. At most 92 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

granularity (query)stringoptional

Period of each row: total (default), month, week, day or hour (hour covers at most 14 days). Periods start on UTC boundaries.

"total""month""week""day""hour"
group_by (query)stringoptional

Up to two comma-separated dimensions: mcp, tool, transport, outcome.

mcp (query)stringoptional

Comma-separated values (at most 50); matches any. MCP ids.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

agent (query)stringoptional

Comma-separated values (at most 50); matches any. Exact agent values.

called_via (query)stringoptional

Comma-separated values (at most 50); matches any. Exact called via values.

auth_mode (query)stringoptional

Comma-separated values (at most 50); matches any. Exact auth mode values.

transport (query)stringoptional

Comma-separated values (at most 50); matches any. Exact transport values.

outcome (query)stringoptional

Comma-separated values (at most 50); matches any. One of success, error, blocked.

sort (query)stringoptional

Row order: period, requests, p50, p95, p99, avg.

"period""requests""p50""p95""p99""avg"
limit (query)integeroptional

Rows per page, 1 to 5000 (default 500).

min: 1max: 5000default: 500
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/latency?limit=500' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/mcps/{mcp_id}/usage

Usage report for one MCP

The usage report restricted to one MCP of your tenant.

REQUIRESread
Path, query & header parameters 15
mcp_id (path)stringrequired

MCP id (the `id` of an MCP, not its slug).

from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: UTC midnight 7 days before `to`. At most 92 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

granularity (query)stringoptional

Period of each row: total (default), month, week, day or hour (hour covers at most 14 days). Periods start on UTC boundaries.

"total""month""week""day""hour"
group_by (query)stringoptional

Up to two comma-separated dimensions: mcp, tool, user, agent, called_via, auth_mode, transport, outcome.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

agent (query)stringoptional

Comma-separated values (at most 50); matches any. Exact agent values.

called_via (query)stringoptional

Comma-separated values (at most 50); matches any. Exact called via values.

auth_mode (query)stringoptional

Comma-separated values (at most 50); matches any. Exact auth mode values.

transport (query)stringoptional

Comma-separated values (at most 50); matches any. Exact transport values.

outcome (query)stringoptional

Comma-separated values (at most 50); matches any. One of success, error, blocked.

sort (query)stringoptional

Row order: period, requests, errors, blocked, duration.

"period""requests""errors""blocked""duration"
limit (query)integeroptional

Rows per page, 1 to 5000 (default 500).

min: 1max: 5000default: 500
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/mcps/a1b2c3d4/usage?limit=500' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/requests

List tool calls

Tool-call metadata, newest first (default the last 24 hours, at most 31 days): MCP, tool, user, agent, outcome, duration and DLP outcome. Never tool arguments, responses, error text, headers or tokens.

REQUIRESread
Path, query & header parameters 14
from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: 24 hours before `to`. At most 31 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

mcp (query)stringoptional

Comma-separated values (at most 50); matches any. MCP ids.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

agent (query)stringoptional

Comma-separated values (at most 50); matches any. Exact agent values.

called_via (query)stringoptional

Comma-separated values (at most 50); matches any. Exact called via values.

auth_mode (query)stringoptional

Comma-separated values (at most 50); matches any. Exact auth mode values.

transport (query)stringoptional

Comma-separated values (at most 50); matches any. Exact transport values.

outcome (query)stringoptional

Comma-separated values (at most 50); matches any. One of success, error, blocked.

limit (query)integeroptional

Rows per page, 1 to 1000 (default 100).

min: 1max: 1000default: 100
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

blocked (query)booleanoptional

true: blocked calls only; false: calls that were not blocked.

request_id (query)stringoptional

Comma-separated values (at most 50); matches any. Request ids.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/requests?limit=100' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/usage

Usage report

Tool calls, outcomes, unique users and tools, durations and payload sizes per period and up to two dimensions, with totals of the whole selection. Outcome: blocked (DLP or policy), error, or success.

REQUIRESread
Path, query & header parameters 15
from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: UTC midnight 7 days before `to`. At most 92 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

granularity (query)stringoptional

Period of each row: total (default), month, week, day or hour (hour covers at most 14 days). Periods start on UTC boundaries.

"total""month""week""day""hour"
group_by (query)stringoptional

Up to two comma-separated dimensions: mcp, tool, user, agent, called_via, auth_mode, transport, outcome.

mcp (query)stringoptional

Comma-separated values (at most 50); matches any. MCP ids.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

agent (query)stringoptional

Comma-separated values (at most 50); matches any. Exact agent values.

called_via (query)stringoptional

Comma-separated values (at most 50); matches any. Exact called via values.

auth_mode (query)stringoptional

Comma-separated values (at most 50); matches any. Exact auth mode values.

transport (query)stringoptional

Comma-separated values (at most 50); matches any. Exact transport values.

outcome (query)stringoptional

Comma-separated values (at most 50); matches any. One of success, error, blocked.

sort (query)stringoptional

Row order: period, requests, errors, blocked, duration.

"period""requests""errors""blocked""duration"
limit (query)integeroptional

Rows per page, 1 to 5000 (default 500).

min: 1max: 5000default: 500
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/usage?limit=500' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/users

Per-user activity

Per user: calls, successes, errors, blocked calls, MCPs and tools used, first and last seen (default the last 30 days). Calls without a recorded user are one row with `user` null.

REQUIRESread
Path, query & header parameters 13
from (query)stringoptional

Inclusive start: RFC 3339 time with a timezone, or a date (UTC midnight). Default: UTC midnight 30 days before `to`. At most 92 days before `to`.

to (query)stringoptional

Exclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.

mcp (query)stringoptional

Comma-separated values (at most 50); matches any. MCP ids.

tool (query)stringoptional

Comma-separated values (at most 50); matches any. Exact tool values.

user (query)stringoptional

Comma-separated values (at most 50); matches any. User emails (case-insensitive).

agent (query)stringoptional

Comma-separated values (at most 50); matches any. Exact agent values.

called_via (query)stringoptional

Comma-separated values (at most 50); matches any. Exact called via values.

auth_mode (query)stringoptional

Comma-separated values (at most 50); matches any. Exact auth mode values.

transport (query)stringoptional

Comma-separated values (at most 50); matches any. Exact transport values.

outcome (query)stringoptional

Comma-separated values (at most 50); matches any. One of success, error, blocked.

sort (query)stringoptional

Row order: calls, errors, blocked, last_seen, user.

"calls""errors""blocked""last_seen""user"
limit (query)integeroptional

Rows per page, 1 to 1000 (default 100).

min: 1max: 1000default: 100
cursor (query)stringoptional

The `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/users?limit=100' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground

GET/audit

List audit events

Configuration changes of your tenant, newest first, made in the Quilr console (`via` ui) or through this API (`via` management_api, with the key id). Events carry who, what and when, and the names of changed fields when recorded; never the before or after values. `action` and `resource_type` are the same identifiers the Quilr console audit page shows. Filters: `actor`, `action`, `resource_type`, `resource_id`, `via`, `since` and `until`. New events never invalidate a cursor.

REQUIRESread
Path, query & header parameters 9
limit (query)integeroptional

Page size, 1 to 200 (default 50).

min: 1max: 200default: 50
cursor (query)stringoptional

The `next_cursor` of the previous page. 409 `collection_changed` when the list changed; restart.

actor (query)stringoptional

Exact actor email (case-insensitive).

action (query)stringoptional

Exact action as recorded, for example management_key_created.

resource_type (query)stringoptional

Exact resource type as recorded.

resource_id (query)stringoptional

Exact resource id, for example an MCP id.

via (query)stringoptional

ui: changes made in the Quilr console; management_api: changes made through this API.

"ui""management_api"
since (query)stringoptional

Inclusive start: RFC 3339 time with a timezone.

format: date-time
until (query)stringoptional

Exclusive end: RFC 3339 time with a timezone.

format: date-time

No request body.

curl --request GET \
'https://mcpgateway.quilr.ai/mcpgateway/management/v1/audit?limit=50' \
--header 'Authorization: Bearer <management-key>'

Authentication, errors & retry rules Scopes Try it in the playground