Tracelane MCP
Read-only MCP access to Tracelane agent traces and guardrail verdicts for debugging
- 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/mcpAdd 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.RequiredTRACELANE_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.RequiredCLICKHOUSE_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools