DiffCI
Planning and report-checking MCP server for change-aware CI validation by coding agents
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/v1Add to Settings → Connectors → Add custom connector
https://diffci.com/mcp/v1Add to ~/.cursor/mcp.json
{
"mcpServers": {
"diffci": {
"url": "https://diffci.com/mcp/v1"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools