Get MCP activity stats

Get aggregated MCP tool call stats for admin

GET /api/v1/aiAgents/admin/mcp-activity/stats

Error

A valid request URL is required to generate request examples

200

{
  "results": {
    "recentErrors": [
      {
        "sessionGroup": {
          "errorCount": 123,
          "callCount": 123,
          "key": "<string>"
        },
        "sessionId": "<string>",
        "protocolVersion": "<string>",
        "authType": "<string>",
        "userAgent": "<string>",
        "clientVersion": "<string>",
        "clientName": "<string>",
        "durationMs": 123,
        "errorMessage": "<string>",
        "toolArgs": {},
        "toolName": "<string>",
        "agent": {
          "name": "<string>",
          "uuid": "<string>"
        },
        "project": {
          "name": "<string>",
          "uuid": "<string>"
        },
        "user": {
          "email": "<string>",
          "name": "<string>",
          "uuid": "<string>"
        },
        "createdAt": "<string>",
        "uuid": "<string>"
      }
    ],
    "agents": [
      {
        "count": 123,
        "agent": {
          "name": "<string>",
          "uuid": "<string>"
        }
      }
    ],
    "topTools": [
      {
        "count": 123,
        "toolName": "<string>"
      }
    ],
    "errorCalls": 123,
    "totalCalls": 123
  },
  "status": "ok"
}

{
  "error": {
    "name": "<string>",
    "statusCode": 123,
    "data": "<unknown>",
    "message": "<string>"
  },
  "status": "error"
}

Query Parameters

projectUuids · string[]

userUuids · string[]

agentUuids · string[]

toolNames · string[]

clientNames · string[]

dateFrom · string

dateTo · string

Response

200

application/json

Success

results · object · required

Show child attributes

status · enum<string> · required

Available options: ok