Emilia Protocol
Exact-action approval and signed receipts for consequential AI agent actions
- 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-serverAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security
Zero-log MCP server with 49 tools for AI guardrails, secret scanning and EU compliance
- 49 tools
- Remote
- Freemium
- Security

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security