base-escrow-mcp

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

• Buyer creates an escrow deal, depositing ETH or tokens into the contract
• Seller delivers the goods/services off-chain
• Buyer releases funds to seller, or refunds if seller fails to deliver
• 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