base-escrow-mcp

MCP server for AI agents to create and manage P2P escrow deals on Base (ETH or ERC-20).

Install

npx -y base-escrow-mcp

Or add to your MCP config:

{
  "mcpServers": {
    "base-escrow": {
      "command": "npx",
      "args": ["-y", "base-escrow-mcp"],
      "env": {
        "DEPLOYER_PRIVATE_KEY": "your-private-key",
        "RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

Tools (8)

| Tool | Description | Auth | |------|-------------|------| | create_escrow | Create a new escrow deal (ETH or ERC-20) | Key | | release_escrow | Release funds to seller (buyer only) | Key | | refund_escrow | Refund funds to buyer | Key | | dispute_escrow | Flag a dispute on a deal | Key | | get_deal | Get deal details by ID | None | | get_buyer_deals | Get all deals for a buyer address | None | | get_seller_deals | Get all deals for a seller address | None | | get_escrow_info | Get contract info (fee, total deals, treasury) | None |

How It Works

1. Buyer creates an escrow deal, depositing ETH or tokens into the contract
2. Seller delivers the goods/services off-chain
3. Buyer releases funds to seller, or refunds if seller fails to deliver
4. Either party can dispute — treasury resolves disputed deals

Environment Variables

• DEPLOYER_PRIVATE_KEY — Required for write operations (create, release, refund, dispute)
• RPC_URL — Base RPC endpoint (default: https://mainnet.base.org)

Chain

• Network: Base mainnet (chainId 8453)
• Explorer: https://basescan.org

License

MIT