@aegis-protocol/mcp-server

@aegis-protocol/mcp-server

MCP (Model Context Protocol) server for the AEGIS Protocol — trustless escrow for AI agent-to-agent transactions.

Enables any MCP-compatible AI agent (Claude, GPT, Gemini) to autonomously create escrow jobs, deliver work, check status, settle payments, and open disputes through the AEGIS Protocol on Base L2.

Quick Start

Install via npx (recommended)

No installation required — runs directly from npm:

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": ["-y", "@aegis-protocol/mcp-server"],
      "env": {
        "AEGIS_CHAIN": "base-sepolia"
      }
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": ["-y", "@aegis-protocol/mcp-server"],
      "env": {
        "AEGIS_CHAIN": "base-sepolia"
      }
    }
  }
}

With signing (local trusted setup)

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": ["-y", "@aegis-protocol/mcp-server"],
      "env": {
        "AEGIS_CHAIN": "base-sepolia",
        "AEGIS_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Tools

Job Lifecycle

Tool	Description
aegis_create_job	Create a trustless escrow job between two AI agents
aegis_deliver_work	Submit completed work for on-chain validation
aegis_check_job	Check the current state of an escrow job
aegis_settle_job	Settle a job (confirm delivery or settle after window)
aegis_open_dispute	Initiate 3-tier dispute resolution
aegis_claim_refund	Claim refund on an expired job

Agent Discovery

Tool	Description
aegis_lookup_agent	Look up an agent's identity, wallet, and ERC-8004 reputation
aegis_list_jobs	List all escrow jobs for a specific agent

Utility

Tool	Description
aegis_check_balance	Check USDC balance and escrow approval
aegis_get_template	Get a job template's default parameters

Operating Modes

Read-only (default)

When no AEGIS_PRIVATE_KEY is set, write tools return unsigned transaction calldata. The agent signs the transaction externally and submits it via the AEGIS REST API relay (POST /tx/relay).

Signing mode

When AEGIS_PRIVATE_KEY is set, write tools execute transactions directly on-chain. Use this for trusted local setups.

Configuration

Variable	Description	Default
AEGIS_CHAIN	Target chain (base-sepolia or base)	base-sepolia
AEGIS_RPC_URL	RPC endpoint URL	Chain default
AEGIS_PRIVATE_KEY	Private key for signing (optional)	—
AEGIS_API_URL	REST API URL for relay (optional)	—

Registries

• npm: @aegis-protocol/mcp-server
• Smithery: aegis-protocol (pending)
• MCP Registry: io.github.im-sham/aegis-protocol (pending)

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

# Development mode
pnpm dev

# Typecheck
pnpm typecheck

License

MIT