Aegis Protocol

Trustless escrow for AI agent-to-agent transactions on Base L2 with ERC-8004 identity and USDC.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "aegis-protocol": {
      "command": "npx",
      "args": [
        "-y",
        "pnpm@9.15.4"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

AEGIS Protocol

Trustless escrow middleware for AI agent-to-agent transactions.

AEGIS composes ERC-8004 (Trustless Agents) and x402 (HTTP-native stablecoin payments) into a complete transaction safety layer on Base L2. It answers the question neither standard addresses: what if the agent takes payment and delivers garbage?

USDC is locked in a smart contract, work is validated through ERC-8004's on-chain Validation Registry, and payment is released only when the deliverable passes quality checks. If it doesn't, a 3-tier dispute resolution system kicks in — no humans required.

How It Works

Code

Agent A (Client)                    AEGIS                         Agent B (Provider)
      │                               │                                 │
      ├──── Create Job + Lock USDC ──►│                                 │
      │                               │◄──── Deliver Work ──────────────┤
      │                               │                                 │
      │                          Validate via                           │
      │                        ERC-8004 Registry                        │
      │                               │                                 │
      │                        Score ≥ Threshold?                       │
      │                         ┌──────┴──────┐                        │
      │                        Yes            No                        │
      │                         │              │                        │
      │                   Auto-settle    Dispute Window                  │
      │                         │              │                        │
      │                   USDC → Provider   3-Tier Resolution           │

Job Lifecycle

Code

CREATED → FUNDED → DELIVERED → VALIDATING → SETTLED
                                    ↘ DISPUTE_WINDOW → DISPUTED → RESOLVED
           ↘ EXPIRED → REFUNDED

Architecture

Four smart contracts on Base L2:

Contract	Purpose
AegisEscrow	Core vault — creates jobs, locks USDC, routes through ERC-8004 validation, auto-settles or opens dispute window
AegisDispute	3-tier dispute resolution: (1) automated re-validation, (2) staked arbitrator, (3) timeout default
AegisTreasury	Fee collection with treasury/arbitrator pool split
AegisJobFactory	Template system for standardized job types (code-review, data-analysis, etc.)

ERC-8004 Integration

AEGIS composes all three ERC-8004 registries:

Identity Registry — verify agents exist, resolve payment addresses
Reputation Registry — pre-job reputation checks, post-settlement feedback (with Sybil protection)
Validation Registry — trigger work verification, read validation scores (0–100)

Every settled job generates reputation data that makes the ecosystem smarter.

Key Design Decisions

Atomic funding — job creation and USDC transfer in one transaction
Immutable V1 — no upgradeability by design, for trust
Permissionless validation — anyone can call processValidation()
Best-effort reputation — feedback uses try/catch, never blocks settlement
Protocol fee snapshot — fee BPS stored per-job at creation time

Deployed Contracts (Base Sepolia)

Contract	Address
AegisEscrow	`0x8e013cf23f11168B62bA2600d99166507Cbb4aAC`
AegisDispute	`0x9Cbe0bf5080568F56d61F4F3ef0f64909898DcB2`
AegisTreasury	`0xCd2a996Edd6Be2992063fD2A41c0240D77c9e0AA`
AegisJobFactory	`0xD6a9fafA4d1d233075D6c5de2a407942bdc29dbF`

Quick Start

For AI Agents (MCP Server)

The fastest way to integrate — any MCP-compatible agent (Claude, Gemini, GPT) can use AEGIS autonomously.

Terminal

npm install @aegis-protocol/mcp-server

11 tools available: aegis_create_job, aegis_deliver_work, aegis_check_job, aegis_settle_job, aegis_open_dispute, aegis_claim_refund, aegis_lookup_agent, aegis_list_jobs, aegis_check_balance, aegis_get_template, aegis_should_i_escrow

See mcp/README.md for configuration and usage.

For Developers (TypeScript SDK)

Terminal

npm install @aegis-protocol/sdk @aegis-protocol/types

server.ts

import { AegisClient } from '@aegis-protocol/sdk';

const client = AegisClient.create({
  chain: 'base-sepolia',
  rpcUrl: process.env.RPC_URL,
});

// Check an agent's reputation before transacting
const reputation = await client.erc8004.reputation.getSummary(agentId);

// Create an escrow job
const job = await client.escrow.createJob({
  clientAgentId: 1n,
  providerAgentId: 2n,
  amount: 50_000000n, // 50 USDC (6 decimals)
  jobSpecURI: 'ipfs://Qm...',
  jobSpecHash: '0x...',
  validatorAddress: '0x...',
  deadlineSeconds: 86400, // 24 hours
});

For Developers (LangChain / LangGraph)

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples langchain-agent -- "Check agent 1 reputation and summarize escrow risk."

LangChain tool adapters are available in sdk/packages/langchain and can be imported as:

server.ts

import { createAegisLangChainTools } from "@aegis-protocol/langchain";

The native LangChain adapter now includes the advisory entry point aegis_should_i_escrow plus settlement support, so the agent-first funnel matches MCP, ElizaOS, and Virtuals.

For Developers (CrewAI)

Install Python dependencies (one-time):

bash

python3 -m pip install crewai mcp

Run the CrewAI + MCP example:

bash

OPENAI_API_KEY=... python3 sdk/examples/crewai-agent.py "Check agent 1 reputation and summarize escrow risk."

Or through the examples workspace script:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples crewai-agent -- "Check agent 1 reputation and summarize escrow risk."

The example uses CrewAI's MCP integration (MCPServerStdio) to call the published @aegis-protocol/mcp-server tools directly. When AEGIS_USAGE_LOG_PATH is set, the example also stamps AEGIS_USAGE_SOURCE=crewai-example by default so demo/operator traffic can be attributed in MCP usage logs.

For Developers (ElizaOS)

Run the ElizaOS example config summary:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples eliza-character

The ElizaOS plugin package is available in sdk/packages/elizaos and can be imported as:

server.ts

import { createAegisElizaPlugin } from "@aegis-protocol/elizaos";

The example exports a minimal character/plugin config in sdk/examples/eliza-character.ts and includes:

advisory action entry point: AEGIS_SHOULD_I_ESCROW
trust and funding checks: AEGIS_LOOKUP_AGENT, AEGIS_CHECK_BALANCE
write-path actions for signer-enabled runtimes: AEGIS_APPROVE_ESCROW, AEGIS_CREATE_JOB, AEGIS_SUBMIT_DELIVERABLE, AEGIS_SETTLE_JOB

For Developers (Virtuals GAME / ACP)

Run the Virtuals config summary:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples virtuals-agent

The Virtuals adapter package is available in sdk/packages/virtuals and can be imported as:

server.ts

import {
  createAegisVirtualsWorker,
  createAegisVirtualsPrompt,
  createAegisAcpSchemas,
  createAegisAcpResources,
} from "@aegis-protocol/virtuals";

The example exports a minimal Virtuals-ready config in sdk/examples/virtuals-agent.ts and includes:

GAME worker functions for AEGIS advisory/read/write flows
ACP custom requirement/deliverable schemas aligned to AEGIS job creation
ACP resource entries that point operators back to AEGIS docs/MCP surfaces
explicit separation between agent runtime logic and the operator-owned ACP wallet/registry setup

For Developers (REST API)

bash

# Check a job's status
curl https://api.aegis-protocol.xyz/jobs/{jobId}

# Query an agent's reputation
curl https://api.aegis-protocol.xyz/agents/{agentId}

# Stream real-time events
curl https://api.aegis-protocol.xyz/events/stream

See api/ for full route documentation.

Build from Source

bash

# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Install dependencies
forge install

# Build contracts
forge build

# Run tests
forge test -vvv

# Run invariants only
forge test --match-path "test/invariants/*" -vvv

# Gas report
forge test --gas-report

Monorepo Structure

Code

aegis-protocol/
├── src/                    # Solidity contracts
│   ├── AegisEscrow.sol
│   ├── AegisDispute.sol
│   ├── AegisTreasury.sol
│   ├── AegisJobFactory.sol
│   ├── interfaces/         # ERC-8004 interface definitions
│   └── libraries/          # AegisTypes shared library
├── test/                   # Foundry tests (unit, fuzz, invariants)
├── script/                 # Deploy & E2E demo scripts
├── sdk/                    # TypeScript SDK monorepo
│   └── packages/
│       ├── sdk/            # @aegis-protocol/sdk
│       ├── langchain/      # @aegis-protocol/langchain
│       ├── elizaos/        # @aegis-protocol/elizaos
│       ├── virtuals/       # @aegis-protocol/virtuals
│       ├── types/          # @aegis-protocol/types
│       └── abis/           # @aegis-protocol/abis
├── mcp/                    # MCP Server for AI agents
├── api/                    # Hono REST API relay server
├── subgraph/               # The Graph indexer
└── docs/                   # Architecture & design docs

Protocol Parameters

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Aegis Protocol

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "aegis-protocol": { "command": "npx", "args": ["-y", "aegis-protocol"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/aegis-protocol?style=directory)](https://allmcps.com/mcp/aegis-protocol)

HTML Embed

<a href="https://allmcps.com/mcp/aegis-protocol"><img src="https://allmcps.com/api/badge/aegis-protocol?style=directory" alt="Aegis Protocol on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Aegis Protocol →Install in Claude Desktop Install in Cursor Install in VS Code

Aegis Protocol

Trustless escrow for AI agent-to-agent transactions on Base L2 with ERC-8004 identity and USDC.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "aegis-protocol": {
      "command": "npx",
      "args": [
        "-y",
        "pnpm@9.15.4"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

AEGIS Protocol

Trustless escrow middleware for AI agent-to-agent transactions.

How It Works

Code

Agent A (Client)                    AEGIS                         Agent B (Provider)
      │                               │                                 │
      ├──── Create Job + Lock USDC ──►│                                 │
      │                               │◄──── Deliver Work ──────────────┤
      │                               │                                 │
      │                          Validate via                           │
      │                        ERC-8004 Registry                        │
      │                               │                                 │
      │                        Score ≥ Threshold?                       │
      │                         ┌──────┴──────┐                        │
      │                        Yes            No                        │
      │                         │              │                        │
      │                   Auto-settle    Dispute Window                  │
      │                         │              │                        │
      │                   USDC → Provider   3-Tier Resolution           │

Job Lifecycle

Code

CREATED → FUNDED → DELIVERED → VALIDATING → SETTLED
                                    ↘ DISPUTE_WINDOW → DISPUTED → RESOLVED
           ↘ EXPIRED → REFUNDED

Architecture

Four smart contracts on Base L2:

Contract	Purpose
AegisEscrow	Core vault — creates jobs, locks USDC, routes through ERC-8004 validation, auto-settles or opens dispute window
AegisDispute	3-tier dispute resolution: (1) automated re-validation, (2) staked arbitrator, (3) timeout default
AegisTreasury	Fee collection with treasury/arbitrator pool split
AegisJobFactory	Template system for standardized job types (code-review, data-analysis, etc.)

ERC-8004 Integration

AEGIS composes all three ERC-8004 registries:

Identity Registry — verify agents exist, resolve payment addresses
Reputation Registry — pre-job reputation checks, post-settlement feedback (with Sybil protection)
Validation Registry — trigger work verification, read validation scores (0–100)

Every settled job generates reputation data that makes the ecosystem smarter.

Key Design Decisions

Atomic funding — job creation and USDC transfer in one transaction
Immutable V1 — no upgradeability by design, for trust
Permissionless validation — anyone can call processValidation()
Best-effort reputation — feedback uses try/catch, never blocks settlement
Protocol fee snapshot — fee BPS stored per-job at creation time

Deployed Contracts (Base Sepolia)

Contract	Address
AegisEscrow	`0x8e013cf23f11168B62bA2600d99166507Cbb4aAC`
AegisDispute	`0x9Cbe0bf5080568F56d61F4F3ef0f64909898DcB2`
AegisTreasury	`0xCd2a996Edd6Be2992063fD2A41c0240D77c9e0AA`
AegisJobFactory	`0xD6a9fafA4d1d233075D6c5de2a407942bdc29dbF`

Quick Start

For AI Agents (MCP Server)

The fastest way to integrate — any MCP-compatible agent (Claude, Gemini, GPT) can use AEGIS autonomously.

Terminal

npm install @aegis-protocol/mcp-server

See mcp/README.md for configuration and usage.

For Developers (TypeScript SDK)

Terminal

npm install @aegis-protocol/sdk @aegis-protocol/types

server.ts

import { AegisClient } from '@aegis-protocol/sdk';

const client = AegisClient.create({
  chain: 'base-sepolia',
  rpcUrl: process.env.RPC_URL,
});

// Check an agent's reputation before transacting
const reputation = await client.erc8004.reputation.getSummary(agentId);

// Create an escrow job
const job = await client.escrow.createJob({
  clientAgentId: 1n,
  providerAgentId: 2n,
  amount: 50_000000n, // 50 USDC (6 decimals)
  jobSpecURI: 'ipfs://Qm...',
  jobSpecHash: '0x...',
  validatorAddress: '0x...',
  deadlineSeconds: 86400, // 24 hours
});

For Developers (LangChain / LangGraph)

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples langchain-agent -- "Check agent 1 reputation and summarize escrow risk."

LangChain tool adapters are available in sdk/packages/langchain and can be imported as:

server.ts

import { createAegisLangChainTools } from "@aegis-protocol/langchain";

The native LangChain adapter now includes the advisory entry point aegis_should_i_escrow plus settlement support, so the agent-first funnel matches MCP, ElizaOS, and Virtuals.

For Developers (CrewAI)

Install Python dependencies (one-time):

bash

python3 -m pip install crewai mcp

Run the CrewAI + MCP example:

bash

OPENAI_API_KEY=... python3 sdk/examples/crewai-agent.py "Check agent 1 reputation and summarize escrow risk."

Or through the examples workspace script:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples crewai-agent -- "Check agent 1 reputation and summarize escrow risk."

For Developers (ElizaOS)

Run the ElizaOS example config summary:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples eliza-character

The ElizaOS plugin package is available in sdk/packages/elizaos and can be imported as:

server.ts

import { createAegisElizaPlugin } from "@aegis-protocol/elizaos";

The example exports a minimal character/plugin config in sdk/examples/eliza-character.ts and includes:

advisory action entry point: AEGIS_SHOULD_I_ESCROW
trust and funding checks: AEGIS_LOOKUP_AGENT, AEGIS_CHECK_BALANCE
write-path actions for signer-enabled runtimes: AEGIS_APPROVE_ESCROW, AEGIS_CREATE_JOB, AEGIS_SUBMIT_DELIVERABLE, AEGIS_SETTLE_JOB

For Developers (Virtuals GAME / ACP)

Run the Virtuals config summary:

Terminal

npx -y pnpm@9.15.4 -C sdk --filter @aegis-protocol/examples virtuals-agent

The Virtuals adapter package is available in sdk/packages/virtuals and can be imported as:

server.ts

import {
  createAegisVirtualsWorker,
  createAegisVirtualsPrompt,
  createAegisAcpSchemas,
  createAegisAcpResources,
} from "@aegis-protocol/virtuals";

The example exports a minimal Virtuals-ready config in sdk/examples/virtuals-agent.ts and includes:

GAME worker functions for AEGIS advisory/read/write flows
ACP custom requirement/deliverable schemas aligned to AEGIS job creation
ACP resource entries that point operators back to AEGIS docs/MCP surfaces
explicit separation between agent runtime logic and the operator-owned ACP wallet/registry setup

For Developers (REST API)

bash

# Check a job's status
curl https://api.aegis-protocol.xyz/jobs/{jobId}

# Query an agent's reputation
curl https://api.aegis-protocol.xyz/agents/{agentId}

# Stream real-time events
curl https://api.aegis-protocol.xyz/events/stream

See api/ for full route documentation.

Build from Source

bash

# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Install dependencies
forge install

# Build contracts
forge build

# Run tests
forge test -vvv

# Run invariants only
forge test --match-path "test/invariants/*" -vvv

# Gas report
forge test --gas-report

Monorepo Structure

Code

aegis-protocol/
├── src/                    # Solidity contracts
│   ├── AegisEscrow.sol
│   ├── AegisDispute.sol
│   ├── AegisTreasury.sol
│   ├── AegisJobFactory.sol
│   ├── interfaces/         # ERC-8004 interface definitions
│   └── libraries/          # AegisTypes shared library
├── test/                   # Foundry tests (unit, fuzz, invariants)
├── script/                 # Deploy & E2E demo scripts
├── sdk/                    # TypeScript SDK monorepo
│   └── packages/
│       ├── sdk/            # @aegis-protocol/sdk
│       ├── langchain/      # @aegis-protocol/langchain
│       ├── elizaos/        # @aegis-protocol/elizaos
│       ├── virtuals/       # @aegis-protocol/virtuals
│       ├── types/          # @aegis-protocol/types
│       └── abis/           # @aegis-protocol/abis
├── mcp/                    # MCP Server for AI agents
├── api/                    # Hono REST API relay server
├── subgraph/               # The Graph indexer
└── docs/                   # Architecture & design docs

Protocol Parameters

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Aegis Protocol

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "aegis-protocol": { "command": "npx", "args": ["-y", "aegis-protocol"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/aegis-protocol?style=directory)](https://allmcps.com/mcp/aegis-protocol)

HTML Embed

<a href="https://allmcps.com/mcp/aegis-protocol"><img src="https://allmcps.com/api/badge/aegis-protocol?style=directory" alt="Aegis Protocol on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity2/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Aegis Protocol →Install in Claude Desktop Install in Cursor Install in VS Code