# Spoor

> Spoor is an open-source MCP server for developer tools. Read-only MCP server that ranks what changed across metrics, logs and traces. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, Windows, CLI, self-hosted
- **Website:** https://telespoor.com
- **Repository:** https://github.com/asinha07/spoor
- **MCP Registry name:** io.github.asinha07/spoor
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-15

## About

Spoor does the comparison work an agent would otherwise do with raw queries. It looks at one time window against a baseline across request rate, error rate, latency, CPU, memory and consumer lag, plus new and spiking error logs and slower or failing spans. The result is a short ranked answer, typically a few hundred tokens, with the service where a failure started on top.

Callers that only suffer from a broken dependency are labelled as originating elsewhere (for example "originates in payment") and moved down. Errors that were already present are listed as steady rather than new, and a coverage section says when a backend returned no data, so "no change" is never confused with "can't see".

The README describes it as deterministic Go with no LLM inside, read-only, with emails, tokens and IPs scrubbed from output. Backends are VictoriaMetrics, VictoriaLogs, VictoriaTraces, Prometheus, Loki, Tempo and New Relic, chosen through environment variables. It ships as a static binary, a Go install or an OCI image under Apache-2.0.

## Features

- **Cross-signal change ranking:** Compares metrics, logs and traces for the same window against the same baseline.
- **Cause versus echo:** Uses trace trees to show where failures start and demotes callers that only suffer.
- **Steady errors called out:** Lists errors that were already there as not new, so agents stop blaming them.
- **Coverage reporting:** States when a backend failed or had no data instead of reporting no change.
- **Token budget:** Every tool accepts budget_tokens, default 800, to bound the answer size.
- **Mixed backends:** Switch metrics, logs and traces between Victoria, Prometheus, Loki, Tempo or New Relic.

## Good for

- Find which service an incident started in after an alert fires
- Let an AI agent triage a failing deploy using a few tool calls
- Separate new error patterns from errors that were always present
- Check New Relic or Grafana-stack telemetry from an MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add spoor --env SPOOR_METRICS_TOKEN='<SPOOR_METRICS_TOKEN>' --env SPOOR_LOGS_TOKEN='<SPOOR_LOGS_TOKEN>' --env SPOOR_TRACES_TOKEN='<SPOOR_TRACES_TOKEN>' --env NEW_RELIC_API_KEY='<NEW_RELIC_API_KEY>' -- docker run -i --rm -e SPOOR_METRICS_TOKEN -e SPOOR_LOGS_TOKEN -e SPOOR_TRACES_TOKEN -e NEW_RELIC_API_KEY ghcr.io/asinha07/spoor:0.3.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "-e",
        "NEW_RELIC_API_KEY",
        "ghcr.io/asinha07/spoor:0.3.1"
      ],
      "env": {
        "SPOOR_METRICS_TOKEN": "<SPOOR_METRICS_TOKEN>",
        "SPOOR_LOGS_TOKEN": "<SPOOR_LOGS_TOKEN>",
        "SPOOR_TRACES_TOKEN": "<SPOOR_TRACES_TOKEN>",
        "NEW_RELIC_API_KEY": "<NEW_RELIC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "-e",
        "NEW_RELIC_API_KEY",
        "ghcr.io/asinha07/spoor:0.3.1"
      ],
      "env": {
        "SPOOR_METRICS_TOKEN": "<SPOOR_METRICS_TOKEN>",
        "SPOOR_LOGS_TOKEN": "<SPOOR_LOGS_TOKEN>",
        "SPOOR_TRACES_TOKEN": "<SPOOR_TRACES_TOKEN>",
        "NEW_RELIC_API_KEY": "<NEW_RELIC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "spoor": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "-e",
        "NEW_RELIC_API_KEY",
        "ghcr.io/asinha07/spoor:0.3.1"
      ],
      "env": {
        "SPOOR_METRICS_TOKEN": "<SPOOR_METRICS_TOKEN>",
        "SPOOR_LOGS_TOKEN": "<SPOOR_LOGS_TOKEN>",
        "SPOOR_TRACES_TOKEN": "<SPOOR_TRACES_TOKEN>",
        "NEW_RELIC_API_KEY": "<NEW_RELIC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "-e",
        "NEW_RELIC_API_KEY",
        "ghcr.io/asinha07/spoor:0.3.1"
      ],
      "env": {
        "SPOOR_METRICS_TOKEN": "<SPOOR_METRICS_TOKEN>",
        "SPOOR_LOGS_TOKEN": "<SPOOR_LOGS_TOKEN>",
        "SPOOR_TRACES_TOKEN": "<SPOOR_TRACES_TOKEN>",
        "NEW_RELIC_API_KEY": "<NEW_RELIC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "-e",
        "NEW_RELIC_API_KEY",
        "ghcr.io/asinha07/spoor:0.3.1"
      ],
      "env": {
        "SPOOR_METRICS_TOKEN": "<SPOOR_METRICS_TOKEN>",
        "SPOOR_LOGS_TOKEN": "<SPOOR_LOGS_TOKEN>",
        "SPOOR_TRACES_TOKEN": "<SPOOR_TRACES_TOKEN>",
        "NEW_RELIC_API_KEY": "<NEW_RELIC_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Does Spoor use an LLM internally?

No. The README says it is deterministic Go, so the same input gives the same output.

### Can it change anything in my systems?

No. It is read-only and only calls query endpoints.

### Which backends does it support?

VictoriaMetrics, Prometheus and New Relic for metrics; VictoriaLogs, Loki and New Relic for logs; VictoriaTraces, Tempo and New Relic for traces.

### How do I run it?

As a static binary for macOS, Linux and Windows, with go install, or as the ghcr.io/asinha07/spoor Docker image that speaks MCP over stdio.

### What licence is it under?

Apache-2.0.

### Is Spoor free?

Yes. Spoor is open source, so you can use and self-host it for free.

### How do I add Spoor to Claude Code?

Run this command in your terminal: claude mcp add spoor --env SPOOR_METRICS_TOKEN='<SPOOR_METRICS_TOKEN>' --env SPOOR_LOGS_TOKEN='<SPOOR_LOGS_TOKEN>' --env SPOOR_TRACES_TOKEN='<SPOOR_TRACES_TOKEN>' --env NEW_RELIC_API_KEY='<NEW_RELIC_API_KEY>' -- docker run -i --rm -e SPOOR_METRICS_TOKEN -e SPOOR_LOGS_TOKEN -e SPOOR_TRACES_TOKEN -e NEW_RELIC_API_KEY ghcr.io/asinha07/spoor:0.3.1

### What are the best alternatives to Spoor?

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/spoor
