Get MCP tool log by ID

Retrieves a single MCP tool execution log by ID, including hydrated object-storage payloads when configured.

GET /api/mcp-logs/{id}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>",
  "llm_request_id": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "tool_name": "<string>",
  "server_label": "<string>",
  "virtual_key_id": "<string>",
  "virtual_key_name": "<string>",
  "arguments": {},
  "result": {},
  "error_details": {
    "event_id": "<string>",
    "type": "<string>",
    "is_bifrost_error": true,
    "status_code": 123,
    "error": {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "param": "<string>",
      "event_id": "<string>"
    },
    "extra_fields": {
      "model_requested": "<string>",
      "request_type": "<string>"
    }
  },
  "latency": 123,
  "cost": 123,
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "virtual_key": {}
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id · string · required

MCP tool log ID

Response

200

application/json

MCP tool log found

MCP tool execution log entry

id · string

Unique identifier for the log entry

llm_request_id · string

Links to the LLM request that triggered this tool call

timestamp · string<date-time>

When the tool execution started

tool_name · string

Name of the MCP tool that was executed

server_label · string

Label of the MCP server that provided the tool

virtual_key_id · string

ID of the virtual key used for this tool execution

virtual_key_name · string

Name of the virtual key used for this tool execution

arguments · object

Tool execution arguments

result · object

Tool execution result

error_details · object

Error response from Bifrost

Show child attributes

latency · number

Execution time in milliseconds

cost · number

Cost in dollars for this tool execution

status · enum<string>

Execution status

Available options: processing, success, error

metadata · object

Custom metadata captured from request headers (configured via logging_headers or x-bf-lh-* prefix)

created_at · string<date-time>

When the log entry was created

virtual_key · object

Full virtual key object (populated when virtual_key_id is set)