List MCP Run History

GET

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

GET

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

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/mcp_server/mcp_server_id/mcp_run \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "method": "tools/call",
5       "request": {
6         "arguments": {
7           "status": "delayed"
8         },
9         "name": "query_orders_by_status"
10       },
11       "response": {
12         "content": [
13           {
14             "text": "12 orders are currently delayed.",
15             "type": "text"
16           }
17         ],
18         "isError": false
19       },
20       "id": "01990829-9213-7168-95a4-bf2a3b4c5d6f",
21       "mcp_server_id": "0197a8c1-2b4c-7a91-8e3d-4f5a6b7c8d9e",
22       "created": "2026-07-10T09:01:47Z",
23       "modified": "2026-07-10T09:01:47Z",
24       "request_id": "2",
25       "protocol_version": "2025-06-18",
26       "duration_ms": 184,
27       "sse_event": false
28     },
29     {
30       "method": "tools/list",
31       "request": {},
32       "response": {
33         "tools": [
34           {
35             "description": "Return order counts grouped by status for a date range.",
36             "name": "query_orders_by_status"
37           },
38           {
39             "description": "Summarize shipment volumes by carrier and region.",
40             "name": "query_shipment_summary"
41           }
42         ]
43       },
44       "id": "01990718-8102-7057-8493-af1a2b3c4d5e",
45       "mcp_server_id": "0197a8c1-2b4c-7a91-8e3d-4f5a6b7c8d9e",
46       "created": "2026-07-10T09:00:12Z",
47       "modified": "2026-07-10T09:00:12Z",
48       "request_id": "1",
49       "protocol_version": "2025-06-18",
50       "duration_ms": 38,
51       "sse_event": false
52     }
53   ],
54   "pagination": {
55     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
56     "has_next": true,
57     "page_limit": 25
58   }
59 }

Retrieve execution history for an MCP server.

Lists all tool invocations made through the specified MCP server, including:

MCP method and JSON-RPC request ID
Request and response payloads
Duration in milliseconds
Whether the run was a server-sent event

Useful for:

Debugging tool interactions
Monitoring usage patterns
Auditing external system access
Performance optimization

Retrieve execution history for an MCP server. Lists all tool invocations made through the specified MCP server, including: - MCP method and JSON-RPC request ID - Request and response payloads - Duration in milliseconds - Whether the run was a server-sent event Useful for: - Debugging tool interactions - Monitoring usage patterns - Auditing external system access - Performance optimization

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.

Query parameters

page_limitinteger or nullOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstring or nullOptionalformat: "uuid"

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

methodlist of strings or nullOptional

Filter by MCP methods (can specify multiple)

sse_eventboolean or nullOptional

Filter by server-sent event flag

Response

Successfully retrieved MCP run history

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error