Skip to content
MCP server

mcpspan

Ask your agent which tools fail, what changed in a release and who calls what

Install
Pricing
Freemium
Platforms
API, Web, self-hosted
Runs
Locally or Remotely
Version
0.15.0
Listing updated
3 days ago

About mcpspan

mcpspan is a freemium MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

This is the question-answering side of mcpspan, a separate analytics product for MCP servers. It reads your mcpspan numbers and changes nothing, so an assistant can answer things like which tools failed most this week, how version 1.4.1 compares with 1.4.0, which clients fail more often, and which tools agents are shown but never call.

Two connection routes exist. The remote one is the MCP endpoint built into mcpspan's API, with OAuth sign-in in the browser. The other is an npx command that reads with a read token made under Settings. Self-hosted installs use their own API address, and a public demo accepts any token.

mcpspan itself is MIT licensed with SDKs in eight languages. The cloud edition starts at $9 a month for two servers and 250,000 events, while self-hosting is free.

Install

Run in a terminal

claude mcp add --transport http mcpspan https://api.mcpspan.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.mcpspan.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcpspan": {
      "url": "https://api.mcpspan.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcpspan": {
      "type": "http",
      "url": "https://api.mcpspan.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcpspan": {
      "serverUrl": "https://api.mcpspan.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcpspan": {
      "type": "http",
      "url": "https://api.mcpspan.com/mcp"
    }
  }
}

Configuration

  • MCPSPAN_READ_TOKENA read token, made in mcpspan under Settings → Read tokens.Required
  • MCPSPAN_URLYour installation's API, for self-hosted mcpspan. https://api.mcpspan.com when left out.

What it does

Read-only access
Sees what the dashboard sees and cannot change anything.
Release comparison
Asks how one server version compares with the previous one.
Client breakdown
Finds whether one client fails more often than another.
Never-called tools
Lists tools agents were shown but did not use.
OAuth or token
Connects by browser sign-in or with a read token via npx.
Self-hosted support
Points at your own installation's API address.
Public demo
A demo server answers any token for trying questions.

Good for

  • Find the tools failing most this week
  • Check whether a release made errors worse
  • See what agents request that the server lacks
  • Compare behaviour between Claude and Cursor
  • Review which tools waste context in the tool list

Pricing

Freemium, from $9 a month

Self-hosted free (MIT); Cloud Solo $9/mo, Cloud Pro $29/mo, 14-day trial

Prices change. Check mcpspan.com before you buy.

mcpspan FAQ

Can this assistant change my data?

No. The README says it sees what the dashboard shows and changes nothing.

How do I connect it?

Add https://api.mcpspan.com/mcp as a remote server, or run npx -y mcpspan-mcp with a read token.

Does it work with a self-hosted mcpspan?

Yes, with your API's address plus /mcp, or set MCPSPAN_URL for the npx command. It needs mcpspan 0.13.0 or newer.

What does mcpspan cost?

Self-hosting is free under MIT. Cloud Solo is $9 a month and Cloud Pro is $29 a month, with a 14-day trial.

Is mcpspan free?

mcpspan has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add mcpspan to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcpspan https://api.mcpspan.com/mcp

What are the best alternatives to mcpspan?

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

Alternatives to mcpspan

  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. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data