Read-only, tenant-scoped access to Tracelane agent traces and guardrail verdicts
Connect Runs on your machine
claude mcp add tracelane-mcp -e TRACELANE_API_KEY=<TRACELANE_API_KEY> -e TRACELANE_GATEWAY_URL=<TRACELANE_GATEWAY_URL> -e CLICKHOUSE_URL=<CLICKHOUSE_URL> -e CLICKHOUSE_USER=<CLICKHOUSE_USER> -e CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> -e CLICKHOUSE_DB=<CLICKHOUSE_DB> -e TRACELANE_MCP_TRANSPORT=<TRACELANE_MCP_TRANSPORT> -- npx -y @tracelanedev/[email protected]{
"mcpServers": {
"tracelane-mcp": {
"command": "npx",
"args": [
"-y",
"@tracelanedev/[email protected]"
],
"env": {
"TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
"TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
"CLICKHOUSE_URL": "<CLICKHOUSE_URL>",
"CLICKHOUSE_USER": "<CLICKHOUSE_USER>",
"CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>",
"CLICKHOUSE_DB": "<CLICKHOUSE_DB>",
"TRACELANE_MCP_TRANSPORT": "<TRACELANE_MCP_TRANSPORT>"
}
}
}
}{
"mcpServers": {
"tracelane-mcp": {
"command": "npx",
"args": [
"-y",
"@tracelanedev/[email protected]"
],
"env": {
"TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
"TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
"CLICKHOUSE_URL": "<CLICKHOUSE_URL>",
"CLICKHOUSE_USER": "<CLICKHOUSE_USER>",
"CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>",
"CLICKHOUSE_DB": "<CLICKHOUSE_DB>",
"TRACELANE_MCP_TRANSPORT": "<TRACELANE_MCP_TRANSPORT>"
}
}
}
}{
"servers": {
"tracelane-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tracelanedev/[email protected]"
],
"env": {
"TRACELANE_API_KEY": "<TRACELANE_API_KEY>",
"TRACELANE_GATEWAY_URL": "<TRACELANE_GATEWAY_URL>",
"CLICKHOUSE_URL": "<CLICKHOUSE_URL>",
"CLICKHOUSE_USER": "<CLICKHOUSE_USER>",
"CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>",
"CLICKHOUSE_DB": "<CLICKHOUSE_DB>",
"TRACELANE_MCP_TRANSPORT": "<TRACELANE_MCP_TRANSPORT>"
}
}
}
}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
| Name | Description |
|---|---|
TRACELANE_API_KEYRequired, secret | Tracelane 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. |
TRACELANE_GATEWAY_URLRequired | Base 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. |
CLICKHOUSE_URLOptional | self-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_USEROptional | ClickHouse username. |
CLICKHOUSE_PASSWORDOptional, secret | ClickHouse password. |
CLICKHOUSE_DBOptional | ClickHouse database holding the spans table. |
TRACELANE_MCP_TRANSPORTOptional | Transport to serve. stdio (default) for desktop clients; http for the Streamable HTTP transport. |
Details
| Package | @tracelanedev/[email protected] (NPM, stdio) |
| First published | 9 Oct 2026 |
| Last updated | 9 Oct 2026 |
| Registry name | io.github.tracelane/tracelane-mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.