tracehub-mcp

An MCP server that allows AI assistants to query OpenTelemetry traces from various observability backends like Jaeger, Tempo, and Datadog. It enables debugging LLM applications by finding expensive calls, debugging errors, comparing model performance, and tracking token usage without manual JSON copy-pasting.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by mcpsmiths

Vendor documentation

What you can do with it

Query OpenTelemetry traces for LLM application debugging
Find expensive calls and debug errors in AI workflows
Compare model performance and track token usage

Source and maintenance

Community listingRegistry 0.13.1

mcp-registry: io.github.mcpsmiths/tracehub-mcp@0.13.1 Source repository

Maintenance checked: Nov 1, 2026, 6:06 AM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

tracehub-mcp 0.13.1

pypi

tracehub-mcp package definition

{
  "version": "0.13.1",
  "transport": "stdio",
  "identifier": "tracehub-mcp",
  "registryType": "pypi",
  "environmentVariables": [
    {
      "name": "BACKEND_TYPE",
      "format": "string",
      "choices": [
        "jaeger",
        "tempo",
        "traceloop",
        "datadog",
        "sentry",
        "xray",
        "newrelic",
        "honeycomb"
      ],
      "default": "jaeger",
      "isRequired": true,
      "description": "Which observability backend to query."
    },
    {
      "name": "BACKEND_URL",
      "format": "string",
      "isRequired": true,
      "description": "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."
    },
    {
      "name": "BACKEND_API_KEY",
      "format": "string",
      "description": "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."
    },
    {
      "name": "BACKEND_AWS_REGION",
      "format": "string",
      "description": "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."
    },
    {
      "name": "BACKEND_NEWRELIC_ACCOUNT_ID",
      "format": "string",
      "description": "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."
    },
    {
      "name": "BACKEND_HONEYCOMB_DATASET",
      "format": "string",
      "description": "Honeycomb dataset slug, required for the Honeycomb backend only - the Query Data API is dataset-scoped."
    },
    {
      "name": "BACKEND_APP_KEY",
      "format": "string",
      "description": "Datadog Application key, required in addition to BACKEND_API_KEY for the Datadog backend only."
    },
    {
      "name": "BACKEND_TEMPO_INSTANCE_ID",
      "format": "string",
      "description": "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)."
    },
    {
      "name": "BACKEND_SENTRY_ORG",
      "format": "string",
      "description": "Sentry organization slug, required for the Sentry backend only."
    },
    {
      "name": "BACKEND_SENTRY_PROJECT",
      "format": "string",
      "description": "Sentry project slug, optional for the Sentry backend - narrows queries to one project."
    },
    {
      "name": "BACKEND_ENVIRONMENTS",
      "format": "string",
      "default": "prd",
      "description": "Comma-separated environments for the Traceloop backend only."
    },
    {
      "name": "BACKEND_TIMEOUT",
      "format": "number",
      "default": "30",
      "description": "Request timeout in seconds."
    },
    {
      "name": "BACKEND_MAX_RESPONSE_BYTES",
      "format": "number",
      "default": "67108864",
      "description": "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."
    },
    {
      "name": "LOG_LEVEL",
      "format": "string",
      "choices": [
        "DEBUG",
        "INFO",
        "WARNING",
        "ERROR"
      ],
      "default": "INFO",
      "description": "Logging level."
    },
    {
      "name": "MAX_TRACES_PER_QUERY",
      "format": "number",
      "default": "500",
      "description": "Maximum traces validated per query (1-1000)."
    },
    {
      "name": "SLOW_REQUEST_THRESHOLD_MS",
      "format": "number",
      "description": "Logs a WARNING for any backend request slower than this, independent of LOG_LEVEL. Unset disables slow-request logging."
    },
    {
      "name": "QUERY_CACHE_TTL_SECONDS",
      "format": "number",
      "description": "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."
    },
    {
      "name": "QUERY_CACHE_MAX_ENTRIES",
      "format": "number",
      "default": "1024",
      "description": "Upper bound on the number of cached query results held at once (1-100000); the least-recently-used entry is evicted first."
    },
    {
      "name": "OTEL_EXPORTER_OTLP_ENDPOINT",
      "format": "string",
      "description": "Enables opt-in OTel self-instrumentation of tool calls when set. Unset means zero overhead - no TracerProvider is configured and no middleware is registered."
    },
    {
      "name": "OTEL_SERVICE_NAME",
      "format": "string",
      "default": "tracehub-mcp",
      "description": "Service name reported in self-instrumentation spans, only used when OTEL_EXPORTER_OTLP_ENDPOINT is set."
    },
    {
      "name": "MCP_INCLUDE_ARGS_IN_SPANS",
      "format": "string",
      "choices": [
        "true",
        "false"
      ],
      "default": "false",
      "description": "Include tool call arguments/results as OTel span attributes when self-instrumentation is enabled. Off by default since they may contain sensitive data."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<YOUR_BACKEND_TYPE>",
        "BACKEND_URL": "<YOUR_BACKEND_URL>",
        "BACKEND_API_KEY": "<YOUR_BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<YOUR_BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<YOUR_BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<YOUR_BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<YOUR_BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<YOUR_BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<YOUR_BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<YOUR_BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<YOUR_BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<YOUR_BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<YOUR_BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<YOUR_MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<YOUR_SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<YOUR_QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<YOUR_QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<YOUR_MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<YOUR_BACKEND_TYPE>",
        "BACKEND_URL": "<YOUR_BACKEND_URL>",
        "BACKEND_API_KEY": "<YOUR_BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<YOUR_BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<YOUR_BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<YOUR_BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<YOUR_BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<YOUR_BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<YOUR_BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<YOUR_BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<YOUR_BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<YOUR_BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<YOUR_BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<YOUR_MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<YOUR_SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<YOUR_QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<YOUR_QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<YOUR_MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "tracehub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<YOUR_BACKEND_TYPE>",
        "BACKEND_URL": "<YOUR_BACKEND_URL>",
        "BACKEND_API_KEY": "<YOUR_BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<YOUR_BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<YOUR_BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<YOUR_BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<YOUR_BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<YOUR_BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<YOUR_BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<YOUR_BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<YOUR_BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<YOUR_BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<YOUR_BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<YOUR_MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<YOUR_SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<YOUR_QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<YOUR_QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<YOUR_MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "tracehub-mcp": {
      "command": "uvx",
      "args": [
        "tracehub-mcp==0.13.1"
      ],
      "env": {
        "BACKEND_TYPE": "<YOUR_BACKEND_TYPE>",
        "BACKEND_URL": "<YOUR_BACKEND_URL>",
        "BACKEND_API_KEY": "<YOUR_BACKEND_API_KEY>",
        "BACKEND_AWS_REGION": "<YOUR_BACKEND_AWS_REGION>",
        "BACKEND_NEWRELIC_ACCOUNT_ID": "<YOUR_BACKEND_NEWRELIC_ACCOUNT_ID>",
        "BACKEND_HONEYCOMB_DATASET": "<YOUR_BACKEND_HONEYCOMB_DATASET>",
        "BACKEND_APP_KEY": "<YOUR_BACKEND_APP_KEY>",
        "BACKEND_TEMPO_INSTANCE_ID": "<YOUR_BACKEND_TEMPO_INSTANCE_ID>",
        "BACKEND_SENTRY_ORG": "<YOUR_BACKEND_SENTRY_ORG>",
        "BACKEND_SENTRY_PROJECT": "<YOUR_BACKEND_SENTRY_PROJECT>",
        "BACKEND_ENVIRONMENTS": "<YOUR_BACKEND_ENVIRONMENTS>",
        "BACKEND_TIMEOUT": "<YOUR_BACKEND_TIMEOUT>",
        "BACKEND_MAX_RESPONSE_BYTES": "<YOUR_BACKEND_MAX_RESPONSE_BYTES>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "MAX_TRACES_PER_QUERY": "<YOUR_MAX_TRACES_PER_QUERY>",
        "SLOW_REQUEST_THRESHOLD_MS": "<YOUR_SLOW_REQUEST_THRESHOLD_MS>",
        "QUERY_CACHE_TTL_SECONDS": "<YOUR_QUERY_CACHE_TTL_SECONDS>",
        "QUERY_CACHE_MAX_ENTRIES": "<YOUR_QUERY_CACHE_MAX_ENTRIES>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "MCP_INCLUDE_ARGS_IN_SPANS": "<YOUR_MCP_INCLUDE_ARGS_IN_SPANS>"
      }
    }
  }
}

Let your agent find its tools

Find servers like tracehub-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 6,641