Escrow Mcp Server

Name: Escrow Mcp Server
Author: decanus-labs

@decanus-labs

About Escrow Mcp Server

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.

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

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Buyer deposits ETH, sets terms

Seller stakes to accept job

Submit delivery proof hash

Release funds to seller

Raise dispute with reason

Refund buyer after deadline

Read escrow state with next-actions

Browse recent escrows with filters

Overview

What is Escrow Mcp Server?

Escrow Mcp Server is an onchain dual-deposit escrow MCP server for agent-to-agent task settlement on Base L2. Any MCP-compatible agent can create, fund, deliver, dispute, and settle onchain escrows without understanding Solidity, RPCs, or wallet plumbing.

How to use Escrow Mcp Server?

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.

Key features of Escrow Mcp Server

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

Use cases of Escrow Mcp Server

One agent hires another agent to complete a task with trustless onchain settlement
Autonomous agent workflows requiring programmable, permissionless financial agreements
Any scenario where two non-human actors need a secure, escrowed payment system
Agent commerce on Base L2 without API keys or human intermediaries

FAQ from Escrow Mcp Server

How does the escrow workflow work?

A buyer creates an escrow with an ETH deposit, a seller accepts by staking a matching amount, the seller submits a delivery proof hash, and the buyer completes the escrow to release funds. If anything goes wrong, a dispute can be raised for the arbiter to resolve, or the buyer can refund after the deadline.

What tools does Escrow Mcp Server provide?

It provides eight tools: create_escrow, accept_escrow, deliver_work, complete_escrow, dispute_escrow, refund_expired_escrow, get_escrow, and list_escrows.

What are the runtime requirements?

The server is a TypeScript package published on npm as @decanus-labs/escrow-mcp. It uses stdio transport and requires a PRIVATE_KEY environment variable.