Spoor MCP Server

by asinha07io.github.asinha07/spoorv0.2.1

Tells AI agents what changed across VictoriaMetrics, VictoriaLogs and VictoriaTraces, and where it started: a ranked, token-budgeted digest that separates root causes from echoes using trace structure.

0Dockerstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of Spoor, from the data

Spoor is a monitoring & observability MCP server from asinha07, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

With 0 GitHub stars it ranks #362 of 797 monitoring & observability servers we index.

It runs locally on your machine over stdio and needs 3 secrets (SPOOR_METRICS_TOKEN, SPOOR_LOGS_TOKEN, SPOOR_TRACES_TOKEN); use a scoped, least-privilege key.

Install Spoor MCP server

claude mcp add spoor -e SPOOR_METRICS_URL='<spoor-metrics-url>' -e SPOOR_LOGS_URL='<spoor-logs-url>' -e SPOOR_TRACES_URL='<spoor-traces-url>' -e SPOOR_METRICS_TOKEN='<spoor-metrics-token>' -e SPOOR_LOGS_TOKEN='<spoor-logs-token>' -e SPOOR_TRACES_TOKEN='<spoor-traces-token>' -- docker run -i --rm -e SPOOR_METRICS_URL -e SPOOR_LOGS_URL -e SPOOR_TRACES_URL -e SPOOR_METRICS_TOKEN -e SPOOR_LOGS_TOKEN -e SPOOR_TRACES_TOKEN ghcr.io/asinha07/spoor:0.2.1 serve

{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_URL",
        "-e",
        "SPOOR_LOGS_URL",
        "-e",
        "SPOOR_TRACES_URL",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "ghcr.io/asinha07/spoor:0.2.1",
        "serve"
      ],
      "env": {
        "SPOOR_METRICS_URL": "<spoor-metrics-url>",
        "SPOOR_LOGS_URL": "<spoor-logs-url>",
        "SPOOR_TRACES_URL": "<spoor-traces-url>",
        "SPOOR_METRICS_TOKEN": "<spoor-metrics-token>",
        "SPOOR_LOGS_TOKEN": "<spoor-logs-token>",
        "SPOOR_TRACES_TOKEN": "<spoor-traces-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_URL",
        "-e",
        "SPOOR_LOGS_URL",
        "-e",
        "SPOOR_TRACES_URL",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "ghcr.io/asinha07/spoor:0.2.1",
        "serve"
      ],
      "env": {
        "SPOOR_METRICS_URL": "<spoor-metrics-url>",
        "SPOOR_LOGS_URL": "<spoor-logs-url>",
        "SPOOR_TRACES_URL": "<spoor-traces-url>",
        "SPOOR_METRICS_TOKEN": "<spoor-metrics-token>",
        "SPOOR_LOGS_TOKEN": "<spoor-logs-token>",
        "SPOOR_TRACES_TOKEN": "<spoor-traces-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "spoor": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_URL",
        "-e",
        "SPOOR_LOGS_URL",
        "-e",
        "SPOOR_TRACES_URL",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "ghcr.io/asinha07/spoor:0.2.1",
        "serve"
      ],
      "env": {
        "SPOOR_METRICS_URL": "<spoor-metrics-url>",
        "SPOOR_LOGS_URL": "<spoor-logs-url>",
        "SPOOR_TRACES_URL": "<spoor-traces-url>",
        "SPOOR_METRICS_TOKEN": "<spoor-metrics-token>",
        "SPOOR_LOGS_TOKEN": "<spoor-logs-token>",
        "SPOOR_TRACES_TOKEN": "<spoor-traces-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "spoor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOOR_METRICS_URL",
        "-e",
        "SPOOR_LOGS_URL",
        "-e",
        "SPOOR_TRACES_URL",
        "-e",
        "SPOOR_METRICS_TOKEN",
        "-e",
        "SPOOR_LOGS_TOKEN",
        "-e",
        "SPOOR_TRACES_TOKEN",
        "ghcr.io/asinha07/spoor:0.2.1",
        "serve"
      ],
      "env": {
        "SPOOR_METRICS_URL": "<spoor-metrics-url>",
        "SPOOR_LOGS_URL": "<spoor-logs-url>",
        "SPOOR_TRACES_URL": "<spoor-traces-url>",
        "SPOOR_METRICS_TOKEN": "<spoor-metrics-token>",
        "SPOOR_LOGS_TOKEN": "<spoor-logs-token>",
        "SPOOR_TRACES_TOKEN": "<spoor-traces-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
SPOOR_METRICS_URL	yes	—	VictoriaMetrics URL as seen from the container, e.g. http://host.docker.internal:8428
SPOOR_LOGS_URL	yes	—	VictoriaLogs URL as seen from the container, e.g. http://host.docker.internal:9428
SPOOR_TRACES_URL	yes	—	VictoriaTraces URL as seen from the container, e.g. http://host.docker.internal:10428
SPOOR_METRICS_TOKEN	—	yes	Bearer token for VictoriaMetrics, if it requires one
SPOOR_LOGS_TOKEN	—	yes	Bearer token for VictoriaLogs, if it requires one
SPOOR_TRACES_TOKEN	—	yes	Bearer token for VictoriaTraces, if it requires one

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-16 · 2d ago · GitHub
Latest release
2026-10-16 · 2d ago · GitHub · v0.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-16 · 2d ago · official registry · v0.2.1

How it compares in Monitoring & Observability

Against the most-starred monitoring & observability servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
Spoor (this)	0	—	not measured	—	local
Netdata	81,005	—	not measured	Active	hosted
Firecrawl	7,634	3	4,383	Active	local + hosted
Browser Tools	7,327	—	not measured	—	local
Kubefwd	4,177	—	not measured	Active	local
Radar Kubernetes	3,851	—	not measured	Active	hosted

All monitoring & observability MCP servers

FAQ

›How do I install the Spoor MCP server in Claude Code?

Run: claude mcp add spoor -e SPOOR_METRICS_URL='<spoor-metrics-url>' -e SPOOR_LOGS_URL='<spoor-logs-url>' -e SPOOR_TRACES_URL='<spoor-traces-url>' -e SPOOR_METRICS_TOKEN='<spoor-metrics-token>' -e SPOOR_LOGS_TOKEN='<spoor-logs-token>' -e SPOOR_TRACES_TOKEN='<spoor-traces-token>' -- docker run -i --rm -e SPOOR_METRICS_URL -e SPOOR_LOGS_URL -e SPOOR_TRACES_URL -e SPOOR_METRICS_TOKEN -e SPOOR_LOGS_TOKEN -e SPOOR_TRACES_TOKEN ghcr.io/asinha07/spoor:0.2.1 serve. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Spoor require an API key?

Yes. It expects SPOOR_METRICS_URL, SPOOR_LOGS_URL, SPOOR_TRACES_URL, SPOOR_METRICS_TOKEN, SPOOR_LOGS_TOKEN, SPOOR_TRACES_TOKEN, of which 3 are secrets.

›Can I use Spoor as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Spoor in the official MCP registry?

Yes, as io.github.asinha07/spoor.

Sources and method

Official MCP Registry entry: updated 2026-10-16
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.