Tracehub MCP Server

by mcpsmithsio.github.mcpsmiths/tracehub-mcpv0.12.2

Query OTel traces across Jaeger, Tempo, Traceloop, Datadog, Sentry, X-Ray, New Relic, Honeycomb.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active11d ago

Install Tracehub MCP server

claude mcp add tracehub -e BACKEND_TYPE=jaeger -e BACKEND_URL='<backend-url>' -e BACKEND_API_KEY='<backend-api-key>' -e BACKEND_APP_KEY='<backend-app-key>' -- uvx tracehub-mcp

{
  "mcpServers": {
    "tracehub": {
      "command": "uvx",
      "args": [
        "tracehub-mcp"
      ],
      "env": {
        "BACKEND_TYPE": "jaeger",
        "BACKEND_URL": "<backend-url>",
        "BACKEND_API_KEY": "<backend-api-key>",
        "BACKEND_APP_KEY": "<backend-app-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "tracehub": {
      "command": "uvx",
      "args": [
        "tracehub-mcp"
      ],
      "env": {
        "BACKEND_TYPE": "jaeger",
        "BACKEND_URL": "<backend-url>",
        "BACKEND_API_KEY": "<backend-api-key>",
        "BACKEND_APP_KEY": "<backend-app-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "tracehub": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tracehub-mcp"
      ],
      "env": {
        "BACKEND_TYPE": "jaeger",
        "BACKEND_URL": "<backend-url>",
        "BACKEND_API_KEY": "<backend-api-key>",
        "BACKEND_APP_KEY": "<backend-app-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "tracehub": {
      "command": "uvx",
      "args": [
        "tracehub-mcp"
      ],
      "env": {
        "BACKEND_TYPE": "jaeger",
        "BACKEND_URL": "<backend-url>",
        "BACKEND_API_KEY": "<backend-api-key>",
        "BACKEND_APP_KEY": "<backend-app-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BACKEND_TYPE	yes	—	Which observability backend to query.
BACKEND_URL	yes	—	Backend API endpoint, e.g. http://localhost:16686 for Jaeger, https://api.datadoghq.com for Datadog, https://api.newrelic.com/graphql for New Relic, or https://api.honeycomb.io for Honeycomb. For the X-Ray backend this is decorative only (e.g. https://xray.us-east-1.amazonaws.com) - never dereferenced for a live request.
BACKEND_API_KEY	—	yes	API key or auth token. Required for Traceloop, Datadog, Sentry, New Relic, and Honeycomb; not used by Jaeger, Tempo, or X-Ray. For New Relic this must be a User API key, not an Ingest or License key; for Honeycomb this must be a Configuration Key, not an Ingest or Management key.
BACKEND_AWS_REGION	—	—	AWS region, e.g. us-east-1. Required for the X-Ray backend only - X-Ray authenticates via boto3's standard AWS credential chain, not BACKEND_API_KEY.
BACKEND_NEWRELIC_ACCOUNT_ID	—	—	New Relic account ID, required for the New Relic backend only - NerdGraph queries are user-scoped, not account-scoped, so this identifies which account's data to read.
BACKEND_HONEYCOMB_DATASET	—	—	Honeycomb dataset slug, required for the Honeycomb backend only - the Query Data API is dataset-scoped.
BACKEND_APP_KEY	—	yes	Datadog Application key, required in addition to BACKEND_API_KEY for the Datadog backend only.
BACKEND_TEMPO_INSTANCE_ID	—	—	Grafana Cloud stack/instance ID, used with BACKEND_API_KEY for Basic Auth (Tempo backend only, required for Grafana Cloud-hosted Tempo, not needed for self-hosted Tempo).
BACKEND_SENTRY_ORG	—	—	Sentry organization slug, required for the Sentry backend only.
BACKEND_SENTRY_PROJECT	—	—	Sentry project slug, optional for the Sentry backend - narrows queries to one project.
BACKEND_ENVIRONMENTS	—	—	Comma-separated environments for the Traceloop backend only.
BACKEND_TIMEOUT	—	—	Request timeout in seconds.
LOG_LEVEL	—	—	Logging level.
MAX_TRACES_PER_QUERY	—	—	Maximum traces validated per query (1-1000).
SLOW_REQUEST_THRESHOLD_MS	—	—	Logs a WARNING for any backend request slower than this, independent of LOG_LEVEL. Unset disables slow-request logging.
OTEL_EXPORTER_OTLP_ENDPOINT	—	—	Enables opt-in OTel self-instrumentation of tool calls when set. Unset means zero overhead - no TracerProvider is configured and no middleware is registered.
OTEL_SERVICE_NAME	—	—	Service name reported in self-instrumentation spans, only used when OTEL_EXPORTER_OTLP_ENDPOINT is set.
MCP_INCLUDE_ARGS_IN_SPANS	—	—	Include tool call arguments/results as OTel span attributes when self-instrumentation is enabled. Off by default since they may contain sensitive data.

Freshness

Active — last maintenance signal 11d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 11d ago · GitHub
Latest release
2026-09-20 · 19d ago · GitHub · v0.12.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 19d ago · official registry · v0.12.2

FAQ

›How do I install the Tracehub MCP server in Claude Code?

Run: claude mcp add tracehub -e BACKEND_TYPE=jaeger -e BACKEND_URL='<backend-url>' -e BACKEND_API_KEY='<backend-api-key>' -e BACKEND_APP_KEY='<backend-app-key>' -- uvx tracehub-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Tracehub require an API key?

Yes. It expects BACKEND_TYPE, BACKEND_URL, BACKEND_API_KEY, BACKEND_APP_KEY, of which 2 are secrets.

›Can I use Tracehub as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Tracehub in the official MCP registry?

Yes, as io.github.mcpsmiths/tracehub-mcp.