# Mark: agent escrow

> Mark: agent escrow is a freemium MCP server for finance and payments. Non-custodial 2-of-3 Bitcoin escrow so AI agents can pay each other without trust. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI
- **Website:** https://agentescrow.to
- **Repository:** https://github.com/yuvlero/mark
- **MCP Registry name:** io.github.yuvlero/mark
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Mark is built for the moment two agents who do not know each other agree on a job and a price. The buyer funds a 2-of-3 escrow over Lightning, the seller delivers and is paid when both sign, and the buyer is refunded if the deadline passes with no release. Each agent holds its own key, and the escrow service holds only the arbiter key, so any payout needs two of the three signatures and Mark checks each payout transaction locally before signing.

A neutral arbiter only matters on a timeout refund or a dispute. Every command prints JSON an agent can act on, and a demo command creates a small real deal with a house seller agent so you can try the whole flow with roughly 400 sats on mainnet. Network defaults to Bitcoin mainnet, with a test network available through an environment variable.

The fee schedule is published: deals up to 33,000 sats pay no platform fee, above that 1% of the whole amount, and a ruled dispute adds 5% (minimum 330 sats) from 3,300 sats. Lightning payouts also pay a swap fee. Deal size runs from 335 to 1,000,000 sats.

## Features

- **2-of-3 escrow:** Funds unlock only with two of three signatures from buyer, seller and arbiter.
- **Lightning in and out:** Buyers fund and sellers receive over Lightning, with Ark address payouts also possible.
- **Local key custody:** Keys live on the agent's machine and every payout is checked locally before signing.
- **Timeout refund:** If nothing is delivered by the deadline, the buyer can claim a refund co-signed by the arbiter.
- **Dispute ruling:** A neutral arbiter can rule on a disagreement for an extra fee.
- **Demo deal:** A preview-then-confirm command starts a small real deal with a house seller.

## Good for

- Pay an unfamiliar agent for a task only on delivery
- Get paid by a buyer agent without trusting it
- Settle a design or research job between two agents with a refund deadline
- Try agent-to-agent escrow with a first small mainnet deal

## Install

### Claude Code (Terminal)

```sh
claude mcp add mark --env MARK_PASSWORD='<MARK_PASSWORD>' -- npx -y @yuvlero/mark
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mark": {
      "command": "npx",
      "args": [
        "-y",
        "@yuvlero/mark"
      ],
      "env": {
        "MARK_PASSWORD": "<MARK_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mark": {
      "command": "npx",
      "args": [
        "-y",
        "@yuvlero/mark"
      ],
      "env": {
        "MARK_PASSWORD": "<MARK_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mark": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yuvlero/mark"
      ],
      "env": {
        "MARK_PASSWORD": "<MARK_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mark": {
      "command": "npx",
      "args": [
        "-y",
        "@yuvlero/mark"
      ],
      "env": {
        "MARK_PASSWORD": "<MARK_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mark": {
      "command": "npx",
      "args": [
        "-y",
        "@yuvlero/mark"
      ],
      "env": {
        "MARK_PASSWORD": "<MARK_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Can the escrow server take my funds?

Not alone. It holds only the arbiter key and any payout needs two of three signatures.

### What does it cost?

Free up to 33,000 sats, then 1% of the whole amount, with a 5% dispute surcharge (minimum 330 sats) on deals from 3,300 sats.

### What do I need to run it?

Node 20.19 or newer; start the MCP server with npx -y @yuvlero/mark mcp.

### Is it real money?

Yes. The default network is Bitcoin mainnet; a test network can be selected with MARK_NETWORK.

### Is Mark: agent escrow free?

Mark: agent escrow has a free plan, with paid plans for more usage or features.

### How do I add Mark: agent escrow to Claude Code?

Run this command in your terminal: claude mcp add mark --env MARK_PASSWORD='<MARK_PASSWORD>' -- npx -y @yuvlero/mark

### What are the best alternatives to Mark: agent escrow?

The closest alternatives to Mark: agent escrow are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/mark-agent-escrow
