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>",
  "project_id": "<string>",
  "project_name": "<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": {
      "provider": "anthropic",
      "model_requested": "<string>",
      "request_type": "<string>"
    }
  },
  "latency": 123,
  "cost": 123,
  "status": "processing",
  "metadata": {},
  "plugin_logs": "<string>",
  "redaction_mapping": {
    "input": {},
    "output": {}
  },
  "created_at": "2023-11-07T05:31:56Z",
  "virtual_key": {}
}

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

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

project_id · string | null

The governance project the tool call was scoped to, or null when it named none. Recorded on the row, but the MCP log queries cannot filter on it.

project_name · string | null

The project's name as it stood when the tool call was served.

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)

plugin_logs · string

JSON-serialized plugin log entries grouped by plugin name

redaction_mapping · object

Phase-scoped placeholder-to-original-value mappings for reversible MCP redactions. Present only on log detail responses when the caller has Logs:Reveal.

Show child attributes

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)