emiliaprotocol/emilia-protocol
View on GitHub ↗Consequence firewall for machine actions. EMILIA Gate verifies exact authority before money, code, permissions, infrastructure, or regulated state changes; the open protocol makes the evidence independently verifiable.
840 ★13 forksTypeScriptUpdated 18d ago
What you need to know
EMILIA Protocol is an authority control plane for autonomous AI work — an open (Apache-2.0) protocol with an MCP server that defines finite operating mandates, pre-authorizes consequential tool actions, consumes authority once, and leaves portable evidence so agents can work unattended but only inside approved bounds.
Install
npm install @emilia-protocol/verify (JS) / pip install langchain-emilia (Python) Run the local surface map: npx @emilia-protocol/scan protect ./tools.json then npx @emilia-protocol/scan protect ./tools.json --apply Add EMILIA to Claude/Cursor/Cline: npx -y @emilia-protocol/mcp-server
Usage
- •Protect one privileged MCP tool call; missing evidence is refused (release_payment, delete_repo, deploy_production examples refuse without a receipt)
- •Set a finite mandate once (mission, limits, evidence, expiry) and let the agent work unattended inside it
- •Verify any receipt in-browser at emiliaprotocol.ai/verify — nothing is uploaded
Key features
- ✓Gate enforces each consequential unit of work at the executor/system-of-record boundary (Consequence Firewall): verifies required authority, refuses before mutation, consumes accepted authority once
- ✓Native evidence verification (Trust Receipt, Trust Profile, Trust Decision objects), one-time admission, and portable work records; exact-action CAID binding
- ✓Same-team cross-language verifiers (JS/Python/Go) and formal evidence (TLA+, Tamarin, Alloy); published as IETF Internet-Drafts
- ✓MCP server integration with refusal, exact-action sign, admit-once, and forged-evidence-rejected demo flows
Best for
Enterprises that must let autonomous agents execute real consequences (payments, PRs, production deploys) while keeping authority, evidence, and one-time admission deterministic and auditable.
Caveats
- ⚠Commercial Gate/Assurance Plane are separate; EMILIA is not an auditor or accredited certifier and no public certification program is operating
- ⚠Production requires a durable provenance ledger, shared atomic consumption store, pinned keys, wrapper on every path to the provider credential
- ⚠A lost response becomes INDETERMINATE — a state to reconcile, not permission to retry
Platforms: macOS · Linux · Windows · CloudClients: Claude · Cursor · Cline · MCP clients
Documentation ↗Reviewed 2026-08-11
Topics
agent-securityagentic-aiai-agentsai-securityaudit-evidenceauthorizationauthorization-receiptsconsequence-firewallcryptographyed25519exact-actionformal-verificationhuman-authorizationietfmcpmcp-securitymodel-context-protocolpolicy-enforcementsecurityzero-trust
- Stars
- 840★
- Forks
- 13
- Language
- TypeScript
- License
- Apache-2.0
- Created
- 2026-03-13
- Last push
- 2026-08-17