Documentation Index
Fetch the complete documentation index at: https://docs.mcpcat.io/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Integrate MCPcat with any OpenTelemetry Protocol (OTLP) compatible platform like Jaeger, Grafana Tempo, New Relic, or AWS X-Ray.
Learn more about OpenTelemetry at opentelemetry.io.
Configuration
mcpcat.track(server, null, {
exporters: {
otlp: {
type: "otlp",
endpoint: "http://localhost:4318/v1/traces",
protocol: "http/protobuf",
headers: {
"api-key": "your-api-key"
},
compression: "gzip"
}
}
})
Configuration Fields
| Field | Type | Required | Description |
|---|
endpoint | string | Yes | OTLP endpoint URL |
protocol | string | No | Protocol format: "http/protobuf" or "grpc" (default: "http/protobuf") |
headers | object | No | Additional headers to send with requests |
compression | string | No | Compression method: "gzip" or "none" (default: "none") |
Field Mapping
MCPcat events are mapped to OTLP spans with the following structure:
Trace and Span IDs
| MCPcat Field | OTLP Field | Format |
|---|
session_id | traceId | 32-character hex (SHA256 hash, one per session) |
id | spanId | 16-character hex (SHA256 hash, unique per event) |
Resource Attributes
| MCPcat Internal Field | OTLP Attribute | Description |
|---|
server_name | service.name | MCP server name |
server_version | service.version | MCP server version |
sdk_language | telemetry.sdk.name | "mcpcat-python", "mcpcat-typescript", or "mcpcat-go" |
mcpcat_version | telemetry.sdk.version | MCPcat SDK version |
Span Attributes
| MCPcat Field | OTLP Attribute | Description |
|---|
event_type | mcp.event_type | Event type (e.g., “tools/call”) |
session_id | mcp.session_id | Session identifier |
project_id | mcp.project_id | MCPcat project ID (if provided) |
resource_name | mcp.resource_name | Tool/prompt/resource name |
user_intent | mcp.user_intent | User’s intent (if captured) |
identify_actor_given_id | mcp.actor_id | User identifier (if identified) |
identify_actor_name | mcp.actor_name | User name (if identified) |
client_name | mcp.client_name | MCP client name |
client_version | mcp.client_version | MCP client version |
Span Properties
| Property | Value | Description |
|---|
name | Event type or "mcp.event" | Span display name |
kind | 2 (SPAN_KIND_SERVER) | Indicates server-side span |
startTimeUnixNano | Event timestamp | In nanoseconds |
endTimeUnixNano | Start + duration | In nanoseconds (if duration available) |
status.code | 1 (OK) or 2 (ERROR) | Based on is_error flag |
