getMcpUsersStats

Get per-user MCP stats: AI tool, last usage, total calls, and (with identifier) the current npm package version and its OX verdict.

Examples

GraphQL

query GetMcpUsersStats($input: McpStatsInput) {
  getMcpUsersStats(input: $input) {
    items {
      user
      aiTool
      lastUsage
      totalCalls
      currentVersion
      currentVersionVerdict
    }
    total
  }
}

Variables

This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.

{
  "input": {
    "identifier": "https://mcp.example.com/sse",
    "limit": 100,
    "offset": 0
  }
}

cURL

curl -X POST \
https://api.cloud.ox.security/api/apollo-gateway \
-H 'Content-Type: application/json' \
-H 'Authorization: YOUR_API_TOKEN' \
-d '{
 "query": "query GetMcpUsersStats($input: McpStatsInput) { getMcpUsersStats(input: $input) { items { user aiTool lastUsage totalCalls currentVersion currentVersionVerdict } total } }",
 "variables": {
    "input": {
      "identifier": "https://mcp.example.com/sse",
      "limit": 100,
      "offset": 0
    }
  }
}'

Node.js

const query = 'query GetMcpUsersStats($input: McpStatsInput) { getMcpUsersStats(input: $input) { items { user aiTool lastUsage totalCalls currentVersion currentVersionVerdict } total } }';

fetch("https://api.cloud.ox.security/api/apollo-gateway", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  body: JSON.stringify({
    query: query,
    // This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
    variables: {
      input: {
        identifier: "https://mcp.example.com/sse",
        limit: 100,
        offset: 0
      }
    }
  })
})
.then(response => response.json())
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(error => console.error('Error:', error));

Python

import requests

query = 'query GetMcpUsersStats($input: McpStatsInput) { getMcpUsersStats(input: $input) { items { user aiTool lastUsage totalCalls currentVersion currentVersionVerdict } total } }'

response = requests.post(
  "https://api.cloud.ox.security/api/apollo-gateway",
  headers={
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  json={
    "query": query,
    # This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
    "variables": {
      "input": {
        "identifier": "https://mcp.example.com/sse",
        "limit": 100,
        "offset": 0
      }
    }
  }
)

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print(f"Error: {response.status_code}")
    print(response.text)

Arguments

You can use the following argument(s) to customize your getMcpUsersStats query.

Argument	Description	Supported fields
input McpStatsInput		identifier String limit Int offset Int

Fields

Return type: McpUsersStatsResponse!

You can use the following field(s) to specify what information your getMcpUsersStats query will return. Please note that some fields may have their own subfields.

Field	Description	Supported fields
items [McpUserStatItem!]!	List of per-user MCP usage statistics matching the query criteria	user String! aiTool String lastUsage DateTime totalCalls Int! currentVersion String currentVersionVerdict McpVerdict
data [McpUserStatItem!]! ⚠️	Deprecated: Use items	user String! aiTool String lastUsage DateTime totalCalls Int! currentVersion String currentVersionVerdict McpVerdict
total Int!	Total number of users matching the query criteria