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
