# base-escrow-mcp

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

## Install

```bash
npx -y base-escrow-mcp
```

Or add to your MCP config:

```json
{
  "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