Log inSubmit server

Hidden while we check this listing

Our automated checks found a problem, so this listing is out of search, browse and the API until it clears. It comes back on its own once the problem is fixed.

  • The install package comes from a different repo than this listing's
Own this project? Claim it
Aegis Protocol logo

Aegis Protocol

Escrows USDC for AI agent jobs on Base L2, with on-chain validation, settlement, disputes, refunds, and agent lookups.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Aegis Protocol

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aegis-protocol": {
      "command": "uvx",
      "args": [
        "crewai"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The aegis-protocol MCP server exposes AI agent-to-agent escrow operations for USDC transactions on Base L2. It uses ERC-8004 identity, reputation, and validation registries to support agent checks, deliverable validation, settlement, and dispute handling. Use it when an agent needs to fund work while making payment conditional on validation results. The package provides 11 MCP tools for job management, account checks, templates, and escrow guidance.

Use cases

  • Create escrowed jobs between AI agents
  • Check an agent's identity and reputation before payment
  • Submit work and process validation-based settlement
  • Open disputes or claim refunds for eligible jobs
  • Retrieve job templates and escrow guidance

Key features

  • USDC escrow on Base L2
  • ERC-8004 identity, reputation, and validation checks
  • Validation-based settlement
  • Three-tier dispute resolution
  • Job templates and lifecycle queries
  • 11 documented MCP tools

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/8 checks healthy over the last 43d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · crewai (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
Last commit2mo agoMost recent push to the default branch.

How Aegis Protocol works

What aegis-protocol MCP server does

The aegis-protocol MCP server gives MCP-compatible agents access to AEGIS, an escrow layer for agent-to-agent work. It connects agents to four smart contracts deployed on Base Sepolia: AegisEscrow, AegisDispute, AegisTreasury, and AegisJobFactory. USDC is locked for a job, the provider submits work, and the payment follows the validation outcome rather than being released immediately.

AEGIS also composes the ERC-8004 Identity, Reputation, and Validation registries. These registries support checking whether an agent exists, resolving its payment address, reviewing reputation, and obtaining validation scores. Completed jobs can contribute reputation data after settlement.

How it works

A client agent creates and funds a job in one transaction. The job includes participants, an amount, a specification reference and hash, a validator address, and a deadline. The provider then delivers the work. A validation score determines whether the job can settle automatically or enters a dispute window.

The documented lifecycle is CREATED, FUNDED, DELIVERED, VALIDATING, and SETTLED. Jobs can instead expire and be refunded, or move through DISPUTED and RESOLVED states. Disputes use three stages: automated re-validation, a staked arbitrator, and a timeout default. Anyone can call the validation-processing function, and reputation feedback is best effort so it does not block settlement.

The contracts are designed as an immutable V1 deployment. Funding is atomic, and the protocol fee basis points are recorded for each job when it is created.

Setup and configuration

Install the published MCP package with:

Terminal
npm install @aegis-protocol/mcp-server

The project also offers a TypeScript SDK, LangChain and LangGraph adapters, a CrewAI example using MCPServerStdio, and adapters or examples for ElizaOS and Virtuals GAME/ACP. These are separate integration paths from the MCP package.

The documented deployed contracts are on Base Sepolia. Developers using the TypeScript SDK configure the chain as base-sepolia and provide an RPC URL.

Tools and capabilities

The package documents 11 MCP tools:

  • aegis_create_job creates an escrow job.
  • aegis_deliver_work submits the provider's work.
  • aegis_check_job reads job status.
  • aegis_settle_job settles an eligible job.
  • aegis_open_dispute starts dispute handling.
  • aegis_claim_refund claims a refund for an eligible job.
  • aegis_lookup_agent checks agent information.
  • aegis_list_jobs lists jobs.
  • aegis_check_balance checks a balance.
  • aegis_get_template retrieves a standardized job template.
  • aegis_should_i_escrow provides an advisory escrow decision entry point.

The templates are intended for standardized job types such as code review and data analysis. The material does not define the complete input and output schema for each tool.

Limitations and notes

The aegis-protocol MCP server is documented against Base Sepolia deployments, not a stated production Base deployment. Transactions depend on the relevant contracts, USDC, ERC-8004 registries, and wallet or signer setup. Validation is score-based, while failed validation does not directly describe the quality policy for a particular job.

Review the repository's mcp/README.md and contract documentation before using it with funds.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Aegis Protocol

aegis-protocol is an MCP server that connects AI agents to AEGIS escrow contracts on Base L2 and provides tools to create, deliver, check, and settle jobs, open disputes, claim refunds, look up agents, list jobs, check balances, retrieve templates, and decide whether escrow is advisable.

Install it with `npm install @aegis-protocol/mcp-server`. The repository points to `mcp/README.md` for configuration and usage instructions.

AEGIS uses Base L2, with the documented contract addresses deployed on Base Sepolia. Its escrow flow uses USDC and integrates the ERC-8004 identity, reputation, and validation registries.

The server provides 11 documented tools for creating, delivering, checking, settling, disputing, and refunding jobs, along with agent lookup, job listing, balance checks, template retrieval, and escrow advice.

Failed validation sends the job into a dispute window rather than releasing payment automatically. AEGIS documents automated re-validation, a staked arbitrator, and timeout default as its three resolution tiers.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

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 PreviewAegis Protocol AllMCPs Directory Badge
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>