# ParityDiff

> ParityDiff is a freemium MCP server for developer tools. Check API breaking changes in Cursor or Claude Code from captured OpenAPI evidence. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://paritydiff.com/mcp
- **Repository:** https://github.com/paritydiff-parity-diff/mcp
- **MCP Registry name:** io.github.soumik15630m/paritydiff
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The free public server reads a catalogue of 1,011 public APIs with captured specifications, and answers from stored evidence. It reports release history, classified endpoint changes and SDK package names, and matches an HTTP method and path to a recorded change. Public lookups send identifiers and query parameters to ParityDiff, not repository source.

It needs Node.js 24 or later and runs over stdio. A terminal command, `npx @paritydiff/mcp check --vendor openai --release <id> --repo .`, scans supported JavaScript and TypeScript call sites locally and reports coverage limits. Private contract tools and a validated migration drafting flow require login and a paid workspace entitlement.

The site says self-serve paid checkout is currently on hold and asks you to contact them.

## Features

- **Public API evidence:** Browse 1,011 APIs with captured specs.
- **Release changes:** Find findings for an exact method and path.
- **Local call-site scan:** CLI scans JS and TS code for impact.
- **Provider guidance:** Read a provider's migration notes.
- **Private contracts:** Paid workspaces add private contract tools.
- **Migration drafts:** Request checked migration drafts after login.

## Good for

- Check whether an SDK call hits a breaking change
- Find the endpoint behind a client call
- Review changes between two API releases
- Scan a repo before upgrading a vendor SDK

## Install

### Claude Code (Terminal)

```sh
claude mcp add paritydiff -- npx -y @paritydiff/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "paritydiff": {
      "command": "npx",
      "args": [
        "-y",
        "@paritydiff/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paritydiff": {
      "command": "npx",
      "args": [
        "-y",
        "@paritydiff/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "paritydiff": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@paritydiff/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paritydiff": {
      "command": "npx",
      "args": [
        "-y",
        "@paritydiff/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paritydiff": {
      "command": "npx",
      "args": [
        "-y",
        "@paritydiff/mcp"
      ]
    }
  }
}
```

## Tools

- `list_apis`: Search or page through captured public APIs.
- `get_api`: Inspect captured operations and SDK package names.
- `list_releases`: Read dated specification revisions and classification counts.
- `list_release_changes`: Inspect a release's findings for a method and path.
- `get_provider_migration`: Read a provider's guidance for captured changes.
- `list_private_contracts`: List private contracts (paid).
- `get_workspace`: Read workspace name, plan and role.

## FAQ

### Is the public data free?

Yes, public evidence needs no account or AI credits.

### Does it upload my code?

The page says public lookup tools send identifiers and query parameters, not repository source.

### What Node version?

Node.js 24 or later.

### Can I buy a paid plan now?

Self-serve checkout is on hold; contact ParityDiff.

### Is ParityDiff free?

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

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

Run this command in your terminal: claude mcp add paritydiff -- npx -y @paritydiff/mcp

### What are the best alternatives to ParityDiff?

The closest alternatives to ParityDiff 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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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