# Bernstein

> Bernstein is an open-source MCP server for developer tools. Open-source scheduler that runs coding agents in parallel under policy-as-code rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, self-hosted
- **Website:** https://bernstein.run
- **Repository:** https://github.com/sipyourdrink-ltd/bernstein
- **MCP Registry name:** io.github.sipyourdrink-ltd/bernstein
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

Bernstein sits above your command-line coding agents rather than being one itself. A deterministic Python scheduler, with no model in the coordination loop, hands tasks to agents in parallel, isolates each in its own git worktree, checks lint, types and tests per diff, and merges only what passes. Because the plan is deterministic, it replays to the same task graph.

You write the policy: who may do what, what needs approval, what must be recorded. Bernstein enforces it and produces a signed run receipt that can be verified offline. The site says it works around Claude Code, Codex, Gemini CLI and 40 or more other adapters, and runs on a laptop, on-prem or air-gapped.

The README is blunt about maturity: it is beta, solo-maintained, and version numbers count releases rather than stability, so pinning a version is advised. It installs from PyPI or as an OCI image.

## Features

- **Deterministic scheduling:** No model in the coordination loop, so a plan replays to the same graph.
- **Worktree isolation:** Each agent works in its own git worktree.
- **Per-diff verification:** Runs lint, type and test checks before anything merges.
- **Policy as code:** Approvals and records are set by policy you write.
- **Signed run receipts:** Receipts verify offline.
- **Air-gap friendly:** Runs on a laptop, on-prem or without internet access.

## Good for

- Run several coding agents on one repository at once
- Require approvals before agents change sensitive paths
- Keep an auditable record of what each agent did
- Operate agent workflows in an air-gapped environment

## Install

### Claude Code (Terminal)

```sh
claude mcp add bernstein -- uvx bernstein
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Is it production-ready?

The README calls it beta and solo-maintained, and advises pinning the version.

### How is it installed?

From PyPI as bernstein, or as an OCI image on ghcr.io.

### Which agents does it work with?

The site names Claude Code, Codex and Gemini CLI plus 40 or more adapters.

### Does an LLM decide the task order?

No. The scheduler is deterministic with no model in the coordination loop.

### Is Bernstein free?

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

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

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

### What are the best alternatives to Bernstein?

The closest alternatives to Bernstein 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/bernstein
