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.
/usagereturns tool calls, outcomes, unique users and tools, durations and payload sizes per period and dimension, with totals of the whole selection./latencyreturns duration percentiles (p50, p90, p95, p99), average, maximum and a fixed-edge histogram./dlp/summaryreturns per-request DLP totals by direction (scanned, flagged, blocked). Per-category detection counts are reported separately and never inflate request totals./requestsreturns 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./usersreturns calls, successes, errors, blocked calls, MCPs and tools used, and first and last seen, per user. Calls without a recorded user are one row withusernull.
For full tool-call logs in your own data platform, use the Log Export API.
Report parameters
Report errors
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.
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
/dlp/summaryDLP summary
Per-request DLP totals by direction (scanned, flagged, blocked) and, reported separately so they never inflate request totals, per-category detection counts.
readPath, query & header parameters 12
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
granularity (query)stringoptionalPeriod 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)stringoptionalUp to two comma-separated dimensions: mcp, tool, user, category, direction.
mcp (query)stringoptionalComma-separated values (at most 50); matches any. MCP ids.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
category (query)stringoptionalComma-separated values (at most 50); matches any. Exact category values.
direction (query)stringoptionalComma-separated values (at most 50); matches any. input or output.
sort (query)stringoptionalRow order: period, requests, flagged, blocked.
"period""requests""flagged""blocked"limit (query)integeroptionalRows per page, 1 to 5000 (default 500).
cursor (query)stringoptionalThe `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
/latencyLatency report
Call duration percentiles (p50, p90, p95, p99), average, maximum and a fixed-edge histogram per period and dimension.
readPath, query & header parameters 15
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
granularity (query)stringoptionalPeriod 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)stringoptionalUp to two comma-separated dimensions: mcp, tool, transport, outcome.
mcp (query)stringoptionalComma-separated values (at most 50); matches any. MCP ids.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
agent (query)stringoptionalComma-separated values (at most 50); matches any. Exact agent values.
called_via (query)stringoptionalComma-separated values (at most 50); matches any. Exact called via values.
auth_mode (query)stringoptionalComma-separated values (at most 50); matches any. Exact auth mode values.
transport (query)stringoptionalComma-separated values (at most 50); matches any. Exact transport values.
outcome (query)stringoptionalComma-separated values (at most 50); matches any. One of success, error, blocked.
sort (query)stringoptionalRow order: period, requests, p50, p95, p99, avg.
"period""requests""p50""p95""p99""avg"limit (query)integeroptionalRows per page, 1 to 5000 (default 500).
cursor (query)stringoptionalThe `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
/mcps/{mcp_id}/usageUsage report for one MCP
The usage report restricted to one MCP of your tenant.
readPath, query & header parameters 15
mcp_id (path)stringrequiredMCP id (the `id` of an MCP, not its slug).
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
granularity (query)stringoptionalPeriod 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)stringoptionalUp to two comma-separated dimensions: mcp, tool, user, agent, called_via, auth_mode, transport, outcome.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
agent (query)stringoptionalComma-separated values (at most 50); matches any. Exact agent values.
called_via (query)stringoptionalComma-separated values (at most 50); matches any. Exact called via values.
auth_mode (query)stringoptionalComma-separated values (at most 50); matches any. Exact auth mode values.
transport (query)stringoptionalComma-separated values (at most 50); matches any. Exact transport values.
outcome (query)stringoptionalComma-separated values (at most 50); matches any. One of success, error, blocked.
sort (query)stringoptionalRow order: period, requests, errors, blocked, duration.
"period""requests""errors""blocked""duration"limit (query)integeroptionalRows per page, 1 to 5000 (default 500).
cursor (query)stringoptionalThe `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
/requestsList 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.
readPath, query & header parameters 14
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
mcp (query)stringoptionalComma-separated values (at most 50); matches any. MCP ids.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
agent (query)stringoptionalComma-separated values (at most 50); matches any. Exact agent values.
called_via (query)stringoptionalComma-separated values (at most 50); matches any. Exact called via values.
auth_mode (query)stringoptionalComma-separated values (at most 50); matches any. Exact auth mode values.
transport (query)stringoptionalComma-separated values (at most 50); matches any. Exact transport values.
outcome (query)stringoptionalComma-separated values (at most 50); matches any. One of success, error, blocked.
limit (query)integeroptionalRows per page, 1 to 1000 (default 100).
cursor (query)stringoptionalThe `next_cursor` of the previous page of the same query. 409 `collection_changed` when the result was recomputed and differs.
blocked (query)booleanoptionaltrue: blocked calls only; false: calls that were not blocked.
request_id (query)stringoptionalComma-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
/usageUsage 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.
readPath, query & header parameters 15
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
granularity (query)stringoptionalPeriod 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)stringoptionalUp to two comma-separated dimensions: mcp, tool, user, agent, called_via, auth_mode, transport, outcome.
mcp (query)stringoptionalComma-separated values (at most 50); matches any. MCP ids.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
agent (query)stringoptionalComma-separated values (at most 50); matches any. Exact agent values.
called_via (query)stringoptionalComma-separated values (at most 50); matches any. Exact called via values.
auth_mode (query)stringoptionalComma-separated values (at most 50); matches any. Exact auth mode values.
transport (query)stringoptionalComma-separated values (at most 50); matches any. Exact transport values.
outcome (query)stringoptionalComma-separated values (at most 50); matches any. One of success, error, blocked.
sort (query)stringoptionalRow order: period, requests, errors, blocked, duration.
"period""requests""errors""blocked""duration"limit (query)integeroptionalRows per page, 1 to 5000 (default 500).
cursor (query)stringoptionalThe `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
/usersPer-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.
readPath, query & header parameters 13
from (query)stringoptionalInclusive 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)stringoptionalExclusive end: RFC 3339 time with a timezone, or a date (through the end of that UTC day). Default: now.
mcp (query)stringoptionalComma-separated values (at most 50); matches any. MCP ids.
tool (query)stringoptionalComma-separated values (at most 50); matches any. Exact tool values.
user (query)stringoptionalComma-separated values (at most 50); matches any. User emails (case-insensitive).
agent (query)stringoptionalComma-separated values (at most 50); matches any. Exact agent values.
called_via (query)stringoptionalComma-separated values (at most 50); matches any. Exact called via values.
auth_mode (query)stringoptionalComma-separated values (at most 50); matches any. Exact auth mode values.
transport (query)stringoptionalComma-separated values (at most 50); matches any. Exact transport values.
outcome (query)stringoptionalComma-separated values (at most 50); matches any. One of success, error, blocked.
sort (query)stringoptionalRow order: calls, errors, blocked, last_seen, user.
"calls""errors""blocked""last_seen""user"limit (query)integeroptionalRows per page, 1 to 1000 (default 100).
cursor (query)stringoptionalThe `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
/auditList 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.
readPath, query & header parameters 9
limit (query)integeroptionalPage size, 1 to 200 (default 50).
cursor (query)stringoptionalThe `next_cursor` of the previous page. 409 `collection_changed` when the list changed; restart.
actor (query)stringoptionalExact actor email (case-insensitive).
action (query)stringoptionalExact action as recorded, for example management_key_created.
resource_type (query)stringoptionalExact resource type as recorded.
resource_id (query)stringoptionalExact resource id, for example an MCP id.
via (query)stringoptionalui: changes made in the Quilr console; management_api: changes made through this API.
"ui""management_api"since (query)stringoptionalInclusive start: RFC 3339 time with a timezone.
until (query)stringoptionalExclusive end: RFC 3339 time with a timezone.
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