# Ekbasis

> Ekbasis is a free MCP server for developer tools. Estimate what git commands and multi-step changes will do, as calibrated probabilities. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Website:** https://openinterp.org/ekbasis
- **Repository:** https://github.com/openinterpretability/ekbasis
- **MCP Registry name:** io.github.OpenInterpretability/ekbasis
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Ekbasis is built around a consequence model: given the current state and a proposed action, it answers typed questions such as whether a command will lose work or fail, and what a value will be afterwards. It does this with a single forward pass of about 0.1 seconds and no generated text. The site says it was trained on real executions in throwaway repositories, so its answers reflect what commands did, not what an agent assumed.

The MCP client is a Python package run over stdio. Its EKBASIS_URL setting points at a server, and the maintainers note that the hosted API stopped taking requests on 20 October 2026 with keys and credits no longer sold. The weights and server are public on Hugging Face, so you run your own. The README cites pre-registered studies and publishes release evaluations; a newer Skopos version is described with its own trade-offs, including more confident errors in unfamiliar world families.

## Features

- **Consequence forecasting:** Predicts outcomes of an action as calibrated probabilities.
- **Single-pass answers:** One forward pass, no generated text.
- **Git guard:** Flags work-losing git commands before they run.
- **Open weights:** Weights and server are public for self-hosting.
- **Published evaluations:** Pre-registered studies and release evaluations are documented.

## Good for

- Check whether a git command could lose uncommitted work
- Gate an agent's shell or database step on a risk threshold
- Simulate multi-step changes before running them
- Run a local guard model without a hosted API

## Install

### Claude Code (Terminal)

```sh
claude mcp add ekbasis --env EKBASIS_API_KEY='<EKBASIS_API_KEY>' -- uvx ekbasis
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ekbasis": {
      "command": "uvx",
      "args": [
        "ekbasis"
      ],
      "env": {
        "EKBASIS_API_KEY": "<EKBASIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ekbasis": {
      "command": "uvx",
      "args": [
        "ekbasis"
      ],
      "env": {
        "EKBASIS_API_KEY": "<EKBASIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ekbasis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ekbasis"
      ],
      "env": {
        "EKBASIS_API_KEY": "<EKBASIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ekbasis": {
      "command": "uvx",
      "args": [
        "ekbasis"
      ],
      "env": {
        "EKBASIS_API_KEY": "<EKBASIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ekbasis": {
      "command": "uvx",
      "args": [
        "ekbasis"
      ],
      "env": {
        "EKBASIS_API_KEY": "<EKBASIS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Is the hosted API still available?

No. The site says it stopped taking requests on 2026-10-20 and the model is now download-only.

### What does the client need?

An EKBASIS_URL pointing at a server you run, and an API key only for the old hosted service.

### Does it generate text?

No. It returns calibrated answers in one forward pass.

### What is Skopos?

A newer version trained further on shell, git, SQLite, PostgreSQL and Python scenarios.

### Is Ekbasis free?

Yes. Ekbasis is free to use.

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

Run this command in your terminal: claude mcp add ekbasis --env EKBASIS_API_KEY='<EKBASIS_API_KEY>' -- uvx ekbasis

### What are the best alternatives to Ekbasis?

The closest alternatives to Ekbasis 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/ekbasis
