Skip to content
MCP server

Emilia Protocol

Exact-action approval and signed receipts for consequential AI agent actions

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
2.1.4
Listing updated
1 day ago

About Emilia Protocol

Emilia Protocol is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • EP_API_KEYAPI key for live action-guard, signoff, and write operations. Public receipt lookup may work without it.
  • EP_INCLUDE_PROTOCOL_TOOLSSet to true to advertise handshake, commit, and delegation tools in addition to the default three-tool action front door.
  • EP_INCLUDE_REGISTRY_TOOLSSet to true to advertise the complete 36-tool legacy registry and reputation catalog.

What it does

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

Pricing

Open source

Open protocol free; public pilot listed at $25K for 90 days

Prices change. Check emiliaprotocol.ai before you buy.

Emilia Protocol 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 to Emilia Protocol

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security