Skip to content
MCP server

DiffCI

Planning and report-checking MCP server for change-aware CI validation by coding agents

Status and history

Answered our latest tool-list check 15 hours ago with 3 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Open source
Platforms
API, CLI, Linux
Runs
Locally or Remotely
Version
0.3.53
Listing updated
3 days ago

About DiffCI

DiffCI is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (3)

Read directly from the server.

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.

What it does

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

Pricing

Open source

MIT licensed; public HTTPS server is free

Prices change. Check diffci.com before you buy.

DiffCI 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 to DiffCI

  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. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools