Skip to content
MCP server

Tracelane MCP

Read-only MCP access to Tracelane agent traces and guardrail verdicts for debugging

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.4.0
Listing updated
1 day ago

About Tracelane MCP

Tracelane MCP is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Tracelane is an observability and guardrail platform for LLM agents, and this server lets Claude Desktop, Claude Code or Cursor inspect its data while you debug. It is read-only by design: no write tools exist, every read is scoped to your tenant, and tool arguments cannot override the tenant or inject raw SQL.

There are two modes. By default it reads through Tracelane's gateway with just an API key; setting CLICKHOUSE_URL switches to self-host mode and reads your own ClickHouse. Its explain_guardrail_block tool turns a flag into a readable account, such as a lethal-trifecta sequence where untrusted input, private data access and an outbound write converge across spans. Trace replay and eval results are also exposed.

It runs over stdio from npm as @tracelanedev/mcp, or serves Streamable HTTP when you run it yourself; no hosted MCP endpoint exists.

Install

Run in a terminal

claude mcp add tracelane-mcp --env TRACELANE_API_KEY='<TRACELANE_API_KEY>' --env TRACELANE_GATEWAY_URL='<TRACELANE_GATEWAY_URL>' --env CLICKHOUSE_PASSWORD='<CLICKHOUSE_PASSWORD>' -- npx -y @tracelanedev/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tracelane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tracelanedev/mcp"
      ],
      "env": {
        "TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
        "TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tracelane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tracelanedev/mcp"
      ],
      "env": {
        "TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
        "TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "tracelane-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tracelanedev/mcp"
      ],
      "env": {
        "TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
        "TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "tracelane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tracelanedev/mcp"
      ],
      "env": {
        "TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
        "TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tracelane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tracelanedev/mcp"
      ],
      "env": {
        "TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
        "TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

Configuration

  • TRACELANE_API_KEYTracelane API key (tlane_…). Resolved to a tenant once at startup via the gateway's /v1/auth/whoami; the server refuses to start if the key is rejected. Also the credential used to read trace data through the gateway when CLICKHOUSE_URL is unset.Required
  • TRACELANE_GATEWAY_URLBase URL of the Tracelane gateway. Validates TRACELANE_API_KEY, and — when CLICKHOUSE_URL is unset — is where every trace read goes. Must be https://…tracelane.dev outside development.Required
  • CLICKHOUSE_URLself-host only; when unset the server reads through the gateway. Set this to point the server at your own ClickHouse instead of Tracelane Cloud.
  • CLICKHOUSE_USERClickHouse username.
  • CLICKHOUSE_PASSWORDClickHouse password.
  • CLICKHOUSE_DBClickHouse database holding the spans table.
  • TRACELANE_MCP_TRANSPORTTransport to serve. stdio (default) for desktop clients; http for the Streamable HTTP transport.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

list_traces
Lists recent traces with optional model and error filters.
get_trace
Returns all spans for a trace.
get_span
Returns full details for a span.
search_traces
Free-text search across span names and attributes.
explain_guardrail_block
Explains a guardrail signal or blocked request.
list_evals
Lists available evals.
get_eval_result
Returns the result of an eval.
replay_trace
Replays a trace, optionally with tool calls.

What it does

Trace browsing
List recent traces and filter by model or errors.
Span detail
Fetch a single span with its LLM attributes.
Free-text search
Search span names and attributes across traces.
Guardrail explanations
Explains why a request was flagged or blocked.
Eval results
Lists evals and returns a given result.
Trace replay
Replays a trace, optionally including tool calls.
Tenant isolation
Reads are tenant-scoped and non-2xx replies surface as errors.

Good for

  • Debug why an agent got stuck in a loop
  • Review which span triggered a guardrail flag
  • Find all traces with errors for one model
  • Check an eval result from your editor

Pricing

Freemium, from $29 a month

Apache 2.0 self-host free; hosted Builder from $29/mo, Team $229, Business $799

Prices change. Check tracelane.dev before you buy.

Tracelane MCP FAQ

Is it read-only?

Yes. No write tools are exposed.

Do I need ClickHouse?

No. Gateway mode needs only TRACELANE_API_KEY; ClickHouse is for self-hosting.

Is there a hosted MCP URL?

No. The README says mcp.tracelane.dev does not resolve, so you run it yourself.

What does Tracelane cost?

The core is Apache 2.0 and free to self-host; hosted tiers start at $29 a month (Builder), with a free hosted tier for non-commercial use.

Is Tracelane MCP free?

Tracelane MCP has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add Tracelane MCP to Claude Code?

Run this command in your terminal: claude mcp add tracelane-mcp --env TRACELANE_API_KEY='<TRACELANE_API_KEY>' --env TRACELANE_GATEWAY_URL='<TRACELANE_GATEWAY_URL>' --env CLICKHOUSE_PASSWORD='<CLICKHOUSE_PASSWORD>' -- npx -y @tracelanedev/mcp

What are the best alternatives to Tracelane MCP?

The closest alternatives to Tracelane MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Tracelane MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools