# Abe

> Abe is an open-source MCP server for security. Local ACT, BLOCK or ESCALATE check that runs before an AI agent takes an action. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://fjp.flowinfo.co/abe
- **Repository:** https://github.com/flowinfosystems-index/abe
- **MCP Registry name:** io.github.flowinfosystems-index/abe
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

Abe sits between an agent and the thing it is about to do: pay an invoice, buy servers, delete a table. You write a plain YAML policy, Abe checks the proposed action against it on your machine and answers ACT, BLOCK or ESCALATE. When several rules apply, BLOCK beats ESCALATE beats ACT, and bad input or a broken rule returns ESCALATE rather than letting the action through.

Policies support 11 operators with all, any and not, per-agent authorization, evidence requirements that report which fields are missing, risk and irreversibility levels, and action classes that always need judgment. Every decision produces a hash-linked record naming the matched rules and policy hash, optionally signed with Ed25519.

The MCP entry point is `abe mcp`, which exposes a fjp_check_action tool. The same engine is also available as a Python or TypeScript library, a Claude Agent SDK hook, a local HTTP sidecar and a Docker image. By default nothing leaves the machine; escalations can optionally go to the Flow resolver with an API key.

## Features

- **Three-way verdict:** Returns ACT, BLOCK or ESCALATE with a reason code.
- **YAML policies:** Rules, authorization, evidence needs and risk levels live in one readable file.
- **Fails closed:** Unmatched actions, bad input and broken rules escalate instead of running.
- **Tamper-evident records:** Each decision gets a hash-verified record, optionally Ed25519 signed.
- **Shadow mode:** Runs beside your current approval process to show where it would agree.
- **Optional Flow resolver:** Sends only escalations, redacted, to Flow for a judgment.

## Good for

- Stop an agent from approving a purchase above a set limit
- Block force-pushes or DROP TABLE in production
- Keep an audit trail of why an agent acted
- Trial a rule set in shadow mode before enforcing it

## Install

### Claude Code (Terminal)

```sh
claude mcp add abe --env ABE_POLICY='<ABE_POLICY>' --env FLOW_API_KEY='<FLOW_API_KEY>' -- uvx abe-ai
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "abe": {
      "command": "uvx",
      "args": [
        "abe-ai"
      ],
      "env": {
        "ABE_POLICY": "<ABE_POLICY>",
        "FLOW_API_KEY": "<FLOW_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "abe": {
      "command": "uvx",
      "args": [
        "abe-ai"
      ],
      "env": {
        "ABE_POLICY": "<ABE_POLICY>",
        "FLOW_API_KEY": "<FLOW_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "abe": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "abe-ai"
      ],
      "env": {
        "ABE_POLICY": "<ABE_POLICY>",
        "FLOW_API_KEY": "<FLOW_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "abe": {
      "command": "uvx",
      "args": [
        "abe-ai"
      ],
      "env": {
        "ABE_POLICY": "<ABE_POLICY>",
        "FLOW_API_KEY": "<FLOW_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "abe": {
      "command": "uvx",
      "args": [
        "abe-ai"
      ],
      "env": {
        "ABE_POLICY": "<ABE_POLICY>",
        "FLOW_API_KEY": "<FLOW_API_KEY>"
      }
    }
  }
}
```

## Tools

- `fjp_check_action`: Checks a proposed agent action against your policy and returns ACT, BLOCK or ESCALATE.

## FAQ

### Does Abe need an API key or network?

No. Checks run locally with no account, key, network or model. Only the optional Flow resolver needs FLOW_API_KEY.

### What happens when no rule matches?

The default policy escalates, so the agent holds and asks a person or resolver.

### What licence is it?

The README states Apache-2.0.

### What does Flow cost?

The README gives about $0.03 to $0.05 per escalated action, and only when you turn the resolver on.

### Is Abe free?

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

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

Run this command in your terminal: claude mcp add abe --env ABE_POLICY='<ABE_POLICY>' --env FLOW_API_KEY='<FLOW_API_KEY>' -- uvx abe-ai

### What are the best alternatives to Abe?

The closest alternatives to Abe 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/abe
