TBUSD Escrow MCP Server

MCP (Model Context Protocol) server that enables AI agents like Claude and Cursor to create and manage trustless escrow payments using TBUSD on Base.

Installation

npm install -g @tbusd/escrow-mcp

Or run directly with npx:

npx @tbusd/escrow-mcp

Configuration

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "tbusd-escrow": {
      "command": "npx",
      "args": ["@tbusd/escrow-mcp"],
      "env": {
        "RPC_URL": "https://mainnet.base.org",
        "PRIVATE_KEY": "0x..."
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "tbusd-escrow": {
      "command": "npx",
      "args": ["@tbusd/escrow-mcp"],
      "env": {
        "RPC_URL": "https://mainnet.base.org",
        "PRIVATE_KEY": "0x..."
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RPC_URL | No | Base RPC URL. Defaults to https://mainnet.base.org | | PRIVATE_KEY | For writes | Wallet private key for creating/managing escrows |

Available Tools

Read Operations (No private key needed)

| Tool | Description | |------|-------------| | get_escrow | Get escrow details including status, parties, amounts | | list_escrows | List all escrows where an address is buyer or seller | | get_balance | Get TBUSD balance for any address |

Write Operations (Private key required)

| Tool | Description | |------|-------------| | create_escrow | Create a new escrow between buyer and seller | | accept_terms | Accept the terms of an escrow | | deposit | Deposit TBUSD into an escrow (auto-approves token) | | release | Release funds to seller | | refund | Refund funds to buyer | | cancel_escrow | Cancel an escrow before funding |

Usage Examples

Once configured, your AI can use escrow naturally:

Creating an escrow:

"Create an escrow for $100 between 0x123... (buyer) and 0x456... (seller) with buyer protection"

Checking status:

"What's the status of escrow 0x789...?"

Managing funds:

"Release the funds in escrow 0x789... to the seller"

Release Types

• 0 - Mutual: Both buyer and seller must approve release/refund
• 1 - BuyerProtected: Buyer controls release and refund (default)
• 2 - SellerProtected: Seller controls release and refund

Contracts

• Factory: 0x1fFA195A86d7E7872EBC2D1d24899addD3f1eB8c
• TBUSD: 0x0d02E2E2a7ADaF2372ca0C69845c8b159A24a595
• Network: Base Mainnet (Chain ID: 8453)

Security

• Never commit your private key to version control
• Use environment variables or a secrets manager
• The private key only needs enough ETH for gas (~0.001 ETH per transaction)
• TBUSD is needed for deposits

More Information

• Website: https://tbusd.io/escrow/agents
• API Docs: https://tbusd.io/escrow/developers
• SDK: https://www.npmjs.com/package/@tbusd/escrow-sdk

License

MIT