# DiffCI

> DiffCI is an open-source MCP server for developer tools. Planning and report-checking MCP server for change-aware CI validation by coding agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Linux, macOS, Windows
- **Website:** https://diffci.com/mcp-server
- **Repository:** https://github.com/diffci/core
- **MCP Registry name:** io.github.DiffCI/diffci
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

DiffCI comes in two forms with different reach. The public HTTPS endpoint is stateless and never executes a command or sees a checkout; it plans a validation command, interprets a submitted observation report and checks a GitHub Actions workflow you paste in. The local stdio package is the one that reads Git history and runs affected tests, returning a receipt of what ran and what was skipped.

Its safety stance is conservative: when evidence is incomplete it falls back to the full suite, and project CI stays authoritative. The workflow check looks for a dedicated, non-blocking, read-only observer job with immutable references. It also ships a `diffci_validate_change` prompt and agent-policy resources.

The engine is MIT licensed and needs Node.js 22.5 or newer for local runs. A GitHub App can post a neutral change-impact check on public repositories.

## Features

- **Validation planning:** Returns a safe local command for change-aware checks or observation.
- **Report interpretation:** Summarizes a diffci.observation.v1 report, including fallbacks and the next action.
- **Workflow safety check:** Verifies an observer job cannot block or influence required CI.
- **Local verification tools:** The stdio server adds diff analysis, affected tests and a structured receipt.
- **Full-suite fallback:** Incomplete evidence leads to running everything.

## Good for

- Tell a coding agent which tests a change affects
- Explain every fallback in an observation report
- Check an observer workflow before adding it to CI
- Gate a push on a receipt of what actually ran

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http diffci https://diffci.com/mcp/v1
```

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

```sh
https://diffci.com/mcp/v1
```

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

```json
{
  "mcpServers": {
    "diffci": {
      "url": "https://diffci.com/mcp/v1"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "diffci": {
      "serverUrl": "https://diffci.com/mcp/v1"
    }
  }
}
```

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

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

## Tools

- `diffci_validation_plan`: Plan change-aware CI validation, affected-test selection, test impact analysis, or GitHub Actions workflow checks. Returns a safe local DiffCI command without accessing the checkout or executing it.
- `diffci_interpret_report`: Validate and summarize a DiffCI observation report, including selective or full mode, affected-test counts, fallbacks, non-interference evidence, and the conservative next action.
- `diffci_verify_workflow_text`: Perform a stateless preliminary safety check of GitHub Actions YAML: dedicated observer job, continue-on-error, dependency isolation, read-only permissions, and immutable DiffCI references.

## FAQ

### What can the public endpoint not do?

It cannot read your checkout or run tests; use the local stdio server for that.

### Does it need an account?

No account is needed for the HTTPS endpoint.

### Which clients are documented?

Codex, Claude Code, Cursor and VS Code.

### Does it replace my CI?

No. Required project CI remains authoritative.

### Is DiffCI free?

Yes. DiffCI is open source, so you can use and self-host it for free.

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

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

### What are the best alternatives to DiffCI?

The closest alternatives to DiffCI 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/diffci
