MCP Calls API
Query and analyze tool call logs from your MCP proxy servers. Every call that passes through the proxy is logged with full request/response data.
Base URL
https://api.hookwatch.dev/v1/mcp/callsThe MCP Call Object
Properties
| Field | Type | Description |
|---|---|---|
id | string | UUID identifier for the call |
mcp_server_id | string | ID of the MCP server this call was proxied through |
method | string | JSON-RPC method (tools/call, tools/list, initialize, etc.) |
tool_name | string | Extracted tool name from tools/call params. Empty for other methods. |
request_body | string | Full JSON-RPC request body as string |
response_body | string | Full JSON-RPC response body from upstream |
status | string | Call status: success, error, or timeout |
status_code | int | HTTP status code from the upstream MCP server |
error_message | string | Error message from JSON-RPC error or HTTP error. Empty on success. |
duration_ms | int | Total round-trip time in milliseconds |
source_ip | string | IP address of the calling client |
headers | object | HTTP request headers from the client |
created_at | string | ISO 8601 timestamp of the call |
List Calls
Retrieve MCP calls with optional filters. Results are paginated and ordered by creation time (newest first).
GET /v1/mcp/callsAll filter parameters are optional and can be combined.
Query Parameters
| Field | Type | Description |
|---|---|---|
server_id | string | Filter by MCP server ID |
method | string | Filter by JSON-RPC method (e.g., tools/call) |
tool_name | string | Filter by tool name |
status | string | Filter by status: success, error, timeout |
from | string | Start of date range (ISO 8601) |
to | string | End of date range (ISO 8601) |
limit | int | Number of results to return (default: 50) |
offset | int | Number of results to skip (default: 0) |
Example
Response
Pagination
Use limit and offset for pagination. The default
limit is 50. Increase offset to fetch subsequent pages.
Get Call
Retrieve a specific call by ID, including full request and response bodies.
GET /v1/mcp/calls/:idPath Parameters
| Field | Type | Description |
|---|---|---|
id | string | The MCP call UUID |
Count Calls
Get a count of calls matching the given filters. Useful for dashboards and analytics.
GET /v1/mcp/calls/countAccepts the same filter parameters as the List endpoint (except limit and offset).
Example
Response
Metrics
Retrieve aggregated metrics for MCP calls over a configurable time range.
GET /v1/mcp/calls/metricsQuery Parameters
| Field | Type | Description |
|---|---|---|
days | int | Time range in days (default: 30) |
server_id | string | Filter metrics by MCP server ID |
Example
Delete Call
Permanently delete a specific call log.
DELETE /v1/mcp/calls/:idExample
Warning
This action is irreversible. The call log will be permanently deleted.
Error Codes
| Status | Error | Description |
|---|---|---|
401 | Unauthorized | Invalid or missing access token |
404 | Not Found | MCP call not found |