ReferenceUntagged
List MCP activity
Get MCP tool call activity for admin
GET/api/v1/aiAgents/admin/mcp-activity
Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | number | No | |
pageSize | number | No | |
projectUuids | array[string] | No | |
userUuids | array[string] | No | |
agentUuids | array[string] | No | |
toolNames | array[string] | No | |
clientNames | array[string] | No | |
status | string | No | |
dateFrom | string | No | |
dateTo | string | No | |
sortField | string | No | |
sortDirection | string | No |
Responses
200 — Success
{
"results": {
"pagination": {
"page": 0,
"pageSize": 0,
"totalResults": 0,
"totalPageCount": 0
},
"data": {
"toolCalls": [
{
"sessionGroup": {
"errorCount": 0,
"callCount": 0,
"key": "string"
},
"sessionId": "string",
"protocolVersion": "string",
"authType": "string",
"userAgent": "string",
"clientVersion": "string",
"clientName": "string",
"durationMs": 0,
"errorMessage": "string",
"status": "success",
"toolArgs": {},
"toolName": "string",
"agent": {
"name": "string",
"uuid": "string"
},
"project": {
"name": "string",
"uuid": "string"
},
"user": {
"email": "string",
"name": "string",
"uuid": "string"
},
"createdAt": "string",
"uuid": "string"
}
]
}
},
"status": "ok"
}default — Error
{
"error": {
"data": "string",
"message": "string",
"name": "string",
"statusCode": 0
},
"status": "error"
}