# Emilia Protocol

> Emilia Protocol is an open-source MCP server for security. Exact-action approval and signed receipts for consequential AI agent actions. 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://www.emiliaprotocol.ai/mcp
- **Repository:** https://github.com/emiliaprotocol/emilia-protocol
- **MCP Registry name:** io.github.emiliaprotocol/mcp-server
- **Categories:** security
- **Listing updated:** 2026-11-16

## About

EMILIA is built around a payment scenario: an agent prepares an $82,000 supplier payment, someone approves it, and then the amount or bank details change. The approval must not carry over. The MCP server adds receipt and passkey verification tools to a client, while a separate package, mcp-guard, protects an existing tool dispatcher. The site is clear that installing the server alone does not mediate another tool's execution path.

The default front door is three tools, with optional protocol tools and a 36-tool legacy registry catalogue switchable by environment variables. Public verification needs no key; an EP_API_KEY unlocks live action-guard, signoff and write operations. Receipts verify offline in JavaScript and Python.

The repository includes demo servers whose dangerous tools, such as release_payment or delete_repo, refuse to run without a receipt. The core is Apache-2.0; the commercial side lists a $25K, 90-day pilot for one protected workflow.

## Features

- **Receipt verification:** Checks authorization receipts offline using signature and Merkle anchor.
- **Passkey signoff checks:** Verifies WebAuthn assertions bound to the exact action.
- **Tool-call guard:** mcp-guard refuses calls without action-bound evidence before the handler runs.
- **Runnable demos:** Offline examples show refusal, approval, replay rejection and forged-receipt rejection.
- **Optional tool sets:** Environment flags add protocol or legacy registry tools.
- **Formal analysis:** The site cites 26 TLA+ invariants checked in CI.

## Good for

- Require signed human approval before releasing a payment
- Block destructive SQL or repo deletion without a receipt
- Verify an authorization receipt offline
- Give auditors evidence of who approved which action

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env EP_API_KEY='<EP_API_KEY>' -- npx -y @emilia-protocol/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": "<EP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": "<EP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": "<EP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": "<EP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@emilia-protocol/mcp-server"
      ],
      "env": {
        "EP_API_KEY": "<EP_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How do I install it?

Add npx -y @emilia-protocol/mcp-server to your MCP client configuration.

### Does it need an API key?

Public verification tools need none; EP_API_KEY enables live and write operations.

### Does installing it protect my other tools?

No. To guard an existing dispatcher use the separate mcp-guard package.

### Is it open source?

Yes, under Apache-2.0.

### Is Emilia Protocol free?

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

### How do I add Emilia Protocol to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env EP_API_KEY='<EP_API_KEY>' -- npx -y @emilia-protocol/mcp-server

### What are the best alternatives to Emilia Protocol?

The closest alternatives to Emilia Protocol are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/emilia-protocol
