# mcpspan

> mcpspan is a freemium MCP server for analytics and data. Ask your agent which tools fail, what changed in a release and who calls what. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, self-hosted, CLI
- **Website:** https://mcpspan.com
- **Repository:** https://github.com/mcpspan/mcpspan/tree/HEAD/packages/mcpspan-mcp
- **MCP Registry name:** io.github.mcpspan/mcpspan
- **Categories:** analytics and data, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.mcpspan.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcpspan": {
      "url": "https://api.mcpspan.com/mcp"
    }
  }
}
```

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

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

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

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

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

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

## 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

- [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/mcpspan
