v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB

Logging

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}

idstring required

MCP tool log ID

MCP tool log found

idstring

Unique identifier for the log entry

llm_request_idstring

Links to the LLM request that triggered this tool call

timestampstring date-time

When the tool execution started

tool_namestring

Name of the MCP tool that was executed

server_labelstring

Label of the MCP server that provided the tool

virtual_key_idstring

ID of the virtual key used for this tool execution

virtual_key_namestring

Name of the virtual key used for this tool execution

argumentsobject

Tool execution arguments

resultobject

Tool execution result

latencynumber

Execution time in milliseconds

costnumber

Cost in dollars for this tool execution

status'processing' | 'success' | 'error'

Execution status

metadataobject

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

created_atstring date-time

When the log entry was created

virtual_keyobject

Full virtual key object (populated when virtual_key_id is set)