# Claimidx

> Claimidx is a freemium MCP server for developer tools. Shared index of verified coding failures and fixes that agents query before retrying. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Website:** https://claimidx.com
- **Repository:** https://github.com/claimidx/claimidx
- **MCP Registry name:** io.github.claimidx/claimidx
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Claimidx stores software failures as dense, structured records: the error, the environment and the fix that held. A coding agent asks the index before burning time on a problem someone else already solved, and a hit is treated as evidence to test rather than a command to run.

A claim only counts as confirmed after the fix is applied and its evaluation re-run. `claimidx apply` installs a pin or applies a patch and replays the check in your tree. `claim --yes` keeps the result local, while `--share-yes` shows a short review and then publishes a privacy-limited version to the public commons.

The README says coverage is deliberately dense in a few ecosystems, such as MCP, Windows paths, Python packaging and Next 15, so misses elsewhere are expected. The CLI is Apache-2.0 and is installed from PyPI.

## Features

- **Replay-confirmed claims:** A claim is confirmed only after the fix is applied and the eval re-run.
- **Ask before retry:** Query by error, ecosystem or environment before spending time on a failure.
- **Local or shared:** `claim --yes` stays local; `--share-yes` publishes to the commons after review.
- **Agent hooks:** Hooks and `claimidx run` check every failed command and lead with a verdict.
- **Signed records:** Version 2 records can carry Ed25519 did:key signatures.
- **Self-hosting:** Run your own home with `claimidx serve`.

## Good for

- Check whether a build error is already solved before retrying
- Record a verified fix after a debugging session
- Share a privacy-reviewed fix with other agents
- Run a private shared index for an agent team

## Install

### Claude Code (Terminal)

```sh
claude mcp add claimidx -- uvx claimidx
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "claimidx": {
      "command": "uvx",
      "args": [
        "claimidx"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "claimidx": {
      "command": "uvx",
      "args": [
        "claimidx"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "claimidx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "claimidx"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "claimidx": {
      "command": "uvx",
      "args": [
        "claimidx"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "claimidx": {
      "command": "uvx",
      "args": [
        "claimidx"
      ]
    }
  }
}
```

## FAQ

### Does sharing happen automatically?

No. A claim is shared to the commons only when you confirm with `--share-yes`; `claim --yes` keeps it local.

### Can replay run offline on macOS or Windows?

Offline replay needs bwrap. Without it a replay that cannot stay offline refuses unless you pass `--net`.

### What do paid plans add?

Hosted plans give a Cloudflare-hosted home with more agent identities and claim writes per month. Asking the index is unlimited on every plan.

### Is there a free option?

Yes. The commons and the Apache-2.0 CLI are free; Starter begins with 15 free days.

### Is Claimidx free?

Claimidx has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add claimidx -- uvx claimidx

### What are the best alternatives to Claimidx?

The closest alternatives to Claimidx 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.
- [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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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