io.github.mcpsmiths/tracehub-mcp

io.github.mcpsmiths/tracehub-mcp

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

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp"
      ],
      "env": {
        "BACKEND_TYPE": "<your BACKEND_TYPE>",
        "BACKEND_URL": "<your BACKEND_URL>",
        "BACKEND_API_KEY": "<your BACKEND_API_KEY>",
        "BACKEND_APP_KEY": "<your BACKEND_APP_KEY>",
        "BACKEND_ENVIRONMENTS": "prd",
        "BACKEND_TIMEOUT": "30",
        "BACKEND_MAX_RESPONSE_BYTES": "67108864",
        "LOG_LEVEL": "INFO",
        "MAX_TRACES_PER_QUERY": "500",
        "QUERY_CACHE_MAX_ENTRIES": "1024",
        "OTEL_SERVICE_NAME": "tracehub-mcp",
        "MCP_INCLUDE_ARGS_IN_SPANS": "false"
      }
    }
  }
}
Environment variables
  • BACKEND_TYPErequiredWhich observability backend to query.
  • BACKEND_URLrequiredBackend 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_KEYsecretAPI 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_APP_KEYsecretDatadog Application key, required in addition to BACKEND_API_KEY for the Datadog backend only.
  • BACKEND_ENVIRONMENTSComma-separated environments for the Traceloop backend only.
  • BACKEND_TIMEOUTRequest timeout in seconds.
  • BACKEND_MAX_RESPONSE_BYTESCeiling 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_LEVELLogging level.
  • MAX_TRACES_PER_QUERYMaximum traces validated per query (1-1000).
  • QUERY_CACHE_MAX_ENTRIESUpper bound on the number of cached query results held at once (1-100000); the least-recently-used entry is evicted first.
  • OTEL_SERVICE_NAMEService name reported in self-instrumentation spans, only used when OTEL_EXPORTER_OTLP_ENDPOINT is set.
  • MCP_INCLUDE_ARGS_IN_SPANSInclude tool call arguments/results as OTel span attributes when self-instrumentation is enabled. Off by default since they may contain sensitive data.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.13.1
Registry
active
Published
10/31/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that io.github.mcpsmiths/tracehub-mcp is listed here — it’s also the link we check for a free listing.

io.github.mcpsmiths/tracehub-mcp — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mcpsmiths-tracehub-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.mcpsmiths/tracehub-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.mcpsmiths/tracehub-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mcpsmiths-tracehub-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.