Escrow Mcp Server

by decanus-labs

289 downloads
Not rated
GitHub

About

The first escrow-native MCP server for agent commerce. Any MCP-compatible agent can create, fund, deliver, dispute, and settle onchain escrows without understanding Solidity, RPCs, or wallet plumbing.

Details

Author
decanus-labs
Downloads
289
Categories
Other

- Dual-deposit escrow: buyer deposits ETH, seller matches stake
- Onchain delivery proof via hash submission
- Dispute resolution by a designated arbiter
- Refund mechanism for expired escrows
- Bilateral deposits ensure both parties have skin in the game
- No Solidity, RPC, or wallet plumbing required for agents

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Escrow Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install and configure the server in your MCP client by adding "command": "npx", "args": ["-y", "@decanus-labs/escrow-mcp"] to your mcpServers config and setting the PRIVATE_KEY environment variable. Interact using the provided tools: create_escrow, accept_escrow, deliver_work, complete_escrow, dispute_escrow, refund_expired_escrow, get_escrow, and list_escrows.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "escrow mcp server": {
            "escrow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@decanus-labs/escrow-mcp"
                ],
                "env": {
                    "PRIVATE_KEY": "0x..."
                }
            }
        }
    }
}

McpServers

{
    "escrow": {
        "command": "npx",
        "args": [
            "-y",
            "@decanus-labs/escrow-mcp"
        ],
        "env": {
            "PRIVATE_KEY": "0x..."
        }
    }
}

Escrow MCP Server

Onchain dual-deposit escrow for agent-to-agent task settlement on Base L2.

Description

The first escrow-native MCP server for agent commerce. Any MCP-compatible agent can create, fund, deliver, dispute, and settle onchain escrows without understanding Solidity, RPCs, or wallet plumbing. Built on Base L2. Powered by the DualDepositEscrow v2 smart contract. Designed for autonomous agent workflows where one agent hires another to complete a task, with bilateral deposits ensuring both parties have skin in the game.

How it works

1. Buyer creates escrow -- deposits ETH, sets seller, arbiter, and deadline 2. Seller accepts -- deposits matching stake (must be >= payment) 3. Seller delivers -- submits delivery proof hash onchain 4. Buyer completes -- releases payment + stake to seller 5. If anything goes wrong: dispute (arbiter resolves) or refund after deadline (buyer gets payment back, seller stake is burned)

Tools

| Tool | Description | |------|-------------| | create_escrow | Buyer deposits ETH, sets terms | | accept_escrow | Seller stakes to accept job | | deliver_work | Submit delivery proof hash | | complete_escrow | Release funds to seller | | dispute_escrow | Raise dispute with reason | | refund_expired_escrow | Refund buyer after deadline | | get_escrow | Read escrow state with next-actions | | list_escrows | Browse recent escrows with filters |

Why this exists

Agents can't open bank accounts. Crypto wallets are the only permissionless financial identity for non-human actors. This MCP server gives any agent framework programmable, trustless settlement on Base L2 -- no API keys, no vendor lock-in, no human intermediary.

Quick start

``json { "mcpServers": { "escrow": { "command": "npx", "args": ["-y", "@decanus-labs/escrow-mcp"], "env": { "PRIVATE_KEY": "0x..." } } } } ``

Category

Finance / Blockchain

Tags

escrow, base, ethereum, onchain, payments, agent-commerce, smart-contract, settlement

Transport

stdio

Language

TypeScript

npm

@decanus-labs/escrow-mcp

Repository

https://github.com/decanus-labs/escrow-mcp

License

MIT
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.