NestDaddy

Tracehub Mcp

io.github.mcpsmiths/tracehub-mcp · v0.13.1

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

Connect Runs on your machine

Terminal
claude mcp add tracehub-mcp -e BACKEND_TYPE=<BACKEND_TYPE> -e BACKEND_URL=<BACKEND_URL> -e BACKEND_API_KEY=<BACKEND_API_KEY> -e BACKEND_AWS_REGION=<BACKEND_AWS_REGION> -e BACKEND_NEWRELIC_ACCOUNT_ID=<BACKEND_NEWRELIC_ACCOUNT_ID> -e BACKEND_HONEYCOMB_DATASET=<BACKEND_HONEYCOMB_DATASET> -e BACKEND_APP_KEY=<BACKEND_APP_KEY> -e BACKEND_TEMPO_INSTANCE_ID=<BACKEND_TEMPO_INSTANCE_ID> -e BACKEND_SENTRY_ORG=<BACKEND_SENTRY_ORG> -e BACKEND_SENTRY_PROJECT=<BACKEND_SENTRY_PROJECT> -e BACKEND_ENVIRONMENTS=<BACKEND_ENVIRONMENTS> -e BACKEND_TIMEOUT=<BACKEND_TIMEOUT> -e BACKEND_MAX_RESPONSE_BYTES=<BACKEND_MAX_RESPONSE_BYTES> -e LOG_LEVEL=<LOG_LEVEL> -e MAX_TRACES_PER_QUERY=<MAX_TRACES_PER_QUERY> -e SLOW_REQUEST_THRESHOLD_MS=<SLOW_REQUEST_THRESHOLD_MS> -e QUERY_CACHE_TTL_SECONDS=<QUERY_CACHE_TTL_SECONDS> -e QUERY_CACHE_MAX_ENTRIES=<QUERY_CACHE_MAX_ENTRIES> -e OTEL_EXPORTER_OTLP_ENDPOINT=<OTEL_EXPORTER_OTLP_ENDPOINT> -e OTEL_SERVICE_NAME=<OTEL_SERVICE_NAME> -e MCP_INCLUDE_ARGS_IN_SPANS=<MCP_INCLUDE_ARGS_IN_SPANS> -- uvx tracehub-mcp==0.13.1
claude_desktop_config.json
{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<BACKEND_TYPE>",
        "BACKEND_URL": "<BACKEND_URL>",
        "BACKEND_API_KEY": "<BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<BACKEND_TYPE>",
        "BACKEND_URL": "<BACKEND_URL>",
        "BACKEND_API_KEY": "<BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "tracehub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<BACKEND_TYPE>",
        "BACKEND_URL": "<BACKEND_URL>",
        "BACKEND_API_KEY": "<BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
BACKEND_TYPE
Required
Which observability backend to query.
BACKEND_URL
Required
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 dereferen…
BACKEND_API_KEY
Optional, secret
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
Optional
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
Optional
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
Optional
Honeycomb dataset slug, required for the Honeycomb backend only - the Query Data API is dataset-scoped.
BACKEND_APP_KEY
Optional, secret
Datadog Application key, required in addition to BACKEND_API_KEY for the Datadog backend only.
BACKEND_TEMPO_INSTANCE_ID
Optional
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
Optional
Sentry organization slug, required for the Sentry backend only.
BACKEND_SENTRY_PROJECT
Optional
Sentry project slug, optional for the Sentry backend - narrows queries to one project.
BACKEND_ENVIRONMENTS
Optional
Comma-separated environments for the Traceloop backend only.
BACKEND_TIMEOUT
Optional
Request timeout in seconds.
BACKEND_MAX_RESPONSE_BYTES
Optional
Ceiling on the decoded size of any single backend response, in bytes (1 to 1073741824). An oversized body is refused before it is buffered or parsed.
LOG_LEVEL
Optional
Logging level.
MAX_TRACES_PER_QUERY
Optional
Maximum traces validated per query (1-1000).
SLOW_REQUEST_THRESHOLD_MS
Optional
Logs a WARNING for any backend request slower than this, independent of LOG_LEVEL. Unset disables slow-request logging.
QUERY_CACHE_TTL_SECONDS
Optional
Cache backend query results for this many seconds with in-flight request coalescing; finite, > 0 and at most 86400 (one day). Unset disables the cache.
QUERY_CACHE_MAX_ENTRIES
Optional
Upper bound on the number of cached query results held at once (1-100000); the least-recently-used entry is evicted first.
OTEL_EXPORTER_OTLP_ENDPOINT
Optional
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
Optional
Service name reported in self-instrumentation spans, only used when OTEL_EXPORTER_OTLP_ENDPOINT is set.
MCP_INCLUDE_ARGS_IN_SPANS
Optional
Include tool call arguments/results as OTel span attributes when self-instrumentation is enabled. Off by default since they may contain sensitive data.

Details

Package[email protected] (PYPI, stdio)
First published31 Oct 2026
Last updated31 Oct 2026
Registry nameio.github.mcpsmiths/tracehub-mcp

More cloud and devops servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.