API ReferenceMcp Runs

Record MCP Run

Record a new MCP tool execution. This endpoint is typically called automatically when tools are invoked, but can be used manually for: - Custom tool integrations - Testing and debugging - Simulating tool calls - Recording manual operations The run record captures the complete interaction for audit and analysis.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path Parameters

mcp_server_idstringRequiredformat: "uuid"
The UUID of the MCP server
org_idstringRequiredformat: "uuid"
The unique identifier of the organization.
project_idstringRequiredformat: "uuid"
The unique identifier of the project.

Request

This endpoint expects an object.
methodstringRequired1-64 characters
MCP method name
requestmap from strings to anyRequired
Request data
responsemap from strings to anyRequired
Response data
mcp_server_idstringRequiredformat: "uuid"
MCP server ID
request_idstring or nullOptional<=255 characters

JSON-RPC request ID

protocol_versionstring or nullOptional<=32 characters
MCP protocol version
duration_msinteger or nullOptional>=0
Duration in milliseconds
sse_eventbooleanOptionalDefaults to false

Whether this is a server-sent event

Response

Successful Response
methodstring1-64 characters
MCP method name
requestmap from strings to any
Request data
responsemap from strings to any
Response data
idstringformat: "uuid"
Unique identifier for the MCP run
mcp_server_idstringformat: "uuid"
MCP server ID
createdstring
Timestamp when the MCP run was created
modifiedstring
Timestamp when the MCP run was last modified
request_idstring or null<=255 characters

JSON-RPC request ID

protocol_versionstring or null<=32 characters
MCP protocol version
duration_msinteger or null>=0
Duration in milliseconds
sse_eventboolean or nullDefaults to false

Whether this is a server-sent event

Errors