Skip to main content

Overview

GetMCP includes built-in analytics that track every tool call made through your MCP servers. Use analytics to:
  • Monitor which tools are being used most
  • Identify errors and failing tool calls
  • Track response times and performance
  • See which AI clients are connecting
  • Set up alerts for unusual usage
Analytics Page

Dashboard Overview

The analytics overview shows at-a-glance metrics for today:
MetricDescription
Total ToolsNumber of tools across all servers
Success RatePercentage of successful tool calls
Avg Response TimeAverage tool execution time in milliseconds
Unique ClientsNumber of unique client IPs
Calls over TimeChart of tool calls
Top ToolsMost called tools
Client BreakdownWhich AI clients are calling your tools
Tool Calls Over Time Response Time Chart

Call Logs

The call log provides a detailed, paginated view of every tool call: Call Logs Each log entry includes:
FieldDescription
TimestampWhen the call was made
ServerWhich MCP server received the call
ToolWhich tool was called
Client TypeAI client that made the call (Claude, Cursor, etc.)
Client IPIP address of the caller
Statussuccess or error
HTTP StatusStatus code returned by the upstream API
Response TimeTime in milliseconds from request to response
Error MessageError details if the call failed
Call Log Details

Filtering Logs

Filter call logs by:
  • Date range — Select from/to dates
  • Server — Filter by a specific server
  • Status — Show only success or error calls
  • Search — Search by server name, tool name, client type, or IP

Exporting Logs

Export filtered logs directly from the Logs page. Apply any filters first, then click the Export dropdown in the top-right toolbar and choose a format. The export includes all matching rows, not just the current page.

CSV

Best for spreadsheets (Excel, Google Sheets) and business reporting.
ID,Timestamp,Server,Tool,Method,Status,HTTP Status,Response Time (ms),Client Type,Client IP,User Agent,Error Message
1,2026-05-19T06:36:15Z,my-server,get_weather,tools/call,success,200,854,cursor,127.0.0.1,Cursor/3.2.16,,
ColumnDescription
IDRow ID
TimestampUTC ISO 8601 timestamp
ServerServer name
ToolTool name
MethodMCP method (tools/call)
Statussuccess or error
HTTP StatusUpstream HTTP status code
Response Time (ms)Round-trip time
Client TypeDetected AI client slug
Client IPCaller IP address
User AgentCaller user-agent string
Error MessageError detail (errors only)

JSON

Best for programmatic processing, dashboards, and data pipelines. Returns a JSON array of objects.
[
  {
    "id": 1,
    "created_at": "2026-05-19T06:36:15Z",
    "server_name": "my-server",
    "tool_name": "get_weather",
    "method": "tools/call",
    "response_status": "success",
    "status_code": 200,
    "response_time_ms": 854,
    "client_type": "cursor",
    "client_ip": "127.0.0.1",
    "user_agent": "Cursor/3.2.16",
    "arguments": {"city": "Dubai"},
    "error_message": null
  }
]

NDJSON

Best for streaming ingestion and log aggregators (Loki, Datadog, Elastic). Each line is a self-contained JSON object.
{"id":1,"created_at":"2026-05-19T06:36:15Z","server_name":"my-server","tool_name":"get_weather","response_status":"success","status_code":200,"response_time_ms":854}
{"id":2,"created_at":"2026-05-19T06:37:27Z","server_name":"my-server","tool_name":"get_weather","response_status":"success","status_code":200,"response_time_ms":745}

Large Exports

Row countBehaviour
0Warning toast; no file downloaded
1 – 5,000Instant download
5,001 – 50,000Download with a browser-slowness warning
50,000+Same warning; consider narrowing your filter or using the API
For recurring large exports, use the Logs API endpoint with per_page and pagination to stream data in chunks:
GET /wp-json/getmcp/v1/analytics/calls?date_from=2026-05-01&date_to=2026-05-31&per_page=500&page=1
Authorization: Bearer YOUR_API_KEY

Client Breakdown

See which AI clients are using your MCP servers: Client Breakdown
ClientDetected By
Claude DesktopUser-Agent header
Claude CodeUser-Agent header
CursorUser-Agent header
WindsurfUser-Agent header
ChatGPTUser-Agent header
UnknownUnrecognized clients

Log Retention

By default, call logs are retained for 30 days. Configure retention in GetMCP → Settings → General. Global Settings — General tab showing Data Retention, Rate Limiting, and Timeout defaults
SettingDefaultDescription
Log Retention Days30How long to keep raw call logs
Analytics Retention Days90How long to keep aggregated daily stats
Default Rate Limit60 req/minApplied to all new servers
Default Timeout30 secondsHow long to wait for upstream API response

Email Alerts

Configure email notifications for errors, high usage, and health check failures at GetMCP → Settings → Notifications. Global Settings — Notifications tab with email alert configuration
SettingDescription
Enable email alertsToggle on to receive alert emails
Notification EmailAddress where alerts are sent
Usage Alert ThresholdDaily call count that triggers a usage alert (default: 80)
Emails use WordPress’s wp_mail(). If alerts aren’t arriving, install an SMTP plugin such as WP Mail SMTP.

Health Checks

Health checks periodically ping your configured tool endpoints to verify they are reachable. Enable them at GetMCP → Settings → Advanced. Global Settings — Advanced tab with health check configuration
SettingDescription
Enable health checksAutomatically test tool endpoints at regular intervals
Check IntervalHow often checks run (every hour, every 6 hours, daily)
Run Health CheckManually trigger a check immediately
Health check failures send an email alert if notifications are enabled.

Analytics API

Access analytics data programmatically via the REST API: