Record MCP Run

POST

/org/:org_id/project/:project_id/mcp_server/:mcp_server_id/mcp_run

POST

/api/v1/org/:org_id/project/:project_id/mcp_server/:mcp_server_id/mcp_run

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/mcp_server/mcp_server_id/mcp_run \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "method": "tools/call",
>   "request": {
>     "arguments": {
>       "status": "delayed"
>     },
>     "name": "query_orders_by_status"
>   },
>   "response": {
>     "content": [
>       {
>         "text": "12 orders are currently delayed.",
>         "type": "text"
>       }
>     ],
>     "isError": false
>   },
>   "mcp_server_id": "0197a8c1-2b4c-7a91-8e3d-4f5a6b7c8d9e",
>   "request_id": "2",
>   "protocol_version": "2025-06-18",
>   "duration_ms": 184,
>   "sse_event": false
> }'

1 {
2   "method": "tools/call",
3   "request": {
4     "arguments": {
5       "status": "delayed"
6     },
7     "name": "query_orders_by_status"
8   },
9   "response": {
10     "content": [
11       {
12         "text": "12 orders are currently delayed.",
13         "type": "text"
14       }
15     ],
16     "isError": false
17   },
18   "id": "01990829-9213-7168-95a4-bf2a3b4c5d6f",
19   "mcp_server_id": "0197a8c1-2b4c-7a91-8e3d-4f5a6b7c8d9e",
20   "created": "2026-07-10T09:01:47Z",
21   "modified": "2026-07-10T09:01:47Z",
22   "request_id": "2",
23   "protocol_version": "2025-06-18",
24   "duration_ms": 184,
25   "sse_event": false
26 }

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. The mcp_server_id in the request body must match the mcp_server_id path parameter.

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. The `mcp_server_id` in the request body must match the `mcp_server_id` path parameter.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

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

MCP run created successfully

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 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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error