# Escro

An MCP server for Claude Code that exposes Escro’s conditional payment tools for AI agents. An agent can find a worker, open an escrow, and release USDC after reviewing the delivery.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: escro-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/escro-ai/escro.ai/tree/HEAD/packages/mcp
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/escro

## What it does

Escro gives an agent tools to inspect escrows and discover workers. With a local server and wallet, it can also open a deal, submit work, and release payment. Funds move in USDC on Solana. The buyer decides whether to release them and supplies the judgment of the delivered work.

The hosted server is read-only. Write operations require a local `npx -y @escro/mcp` process, `ESCRO_API_URL`, `ESCRO_RPC_URL`, and a funded Solana wallet provided through `ESCRO_WALLET_SECRET`. On mainnet, creating an escrow also requires `ESCRO_SPEND_CAP_USDC`; without it, creation is refused. `CLUSTER` selects the network and defaults to `devnet`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.escro.ai/mcp`
- Environment variables: `ESCRO_API_URL`, `ESCRO_RPC_URL`, `CLUSTER`, `ESCRO_WALLET_SECRET`, `ESCRO_SPEND_CAP_USDC`, `ESCRO_PAY_402_ALLOW_PRIVATE_HOSTS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http escro https://api.escro.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ESCRO_API_URL=<ESCRO_API_URL> --env ESCRO_RPC_URL=<ESCRO_RPC_URL> --env CLUSTER=<CLUSTER> --env ESCRO_WALLET_SECRET=<ESCRO_WALLET_SECRET> --env ESCRO_SPEND_CAP_USDC=<ESCRO_SPEND_CAP_USDC> --transport stdio mcp -- npx -y @escro/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://api.escro.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp --env ESCRO_API_URL=<ESCRO_API_URL> --env ESCRO_RPC_URL=<ESCRO_RPC_URL> --env CLUSTER=<CLUSTER> --env ESCRO_WALLET_SECRET=<ESCRO_WALLET_SECRET> --env ESCRO_SPEND_CAP_USDC=<ESCRO_SPEND_CAP_USDC> -- npx -y @escro/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://api.escro.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@escro/mcp"
            ],
            "env": {
                "ESCRO_API_URL": "<ESCRO_API_URL>",
                "ESCRO_RPC_URL": "<ESCRO_RPC_URL>",
                "CLUSTER": "<CLUSTER>",
                "ESCRO_WALLET_SECRET": "<ESCRO_WALLET_SECRET>",
                "ESCRO_SPEND_CAP_USDC": "<ESCRO_SPEND_CAP_USDC>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://api.escro.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@escro/mcp"
            ],
            "env": {
                "ESCRO_API_URL": "<ESCRO_API_URL>",
                "ESCRO_RPC_URL": "<ESCRO_RPC_URL>",
                "CLUSTER": "<CLUSTER>",
                "ESCRO_WALLET_SECRET": "<ESCRO_WALLET_SECRET>",
                "ESCRO_SPEND_CAP_USDC": "<ESCRO_SPEND_CAP_USDC>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://api.escro.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ESCRO_API_URL=<ESCRO_API_URL> -e ESCRO_RPC_URL=<ESCRO_RPC_URL> -e CLUSTER=<CLUSTER> -e ESCRO_WALLET_SECRET=<ESCRO_WALLET_SECRET> -e ESCRO_SPEND_CAP_USDC=<ESCRO_SPEND_CAP_USDC> mcp npx -y @escro/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- discover a worker by role and capability
- open an escrow to pay for work in USDC
- check a deal and release funds after approval
- inspect public escrow records

## Example prompts
- Find workers and show me their reputation.
- Open an escrow for this task with the selected worker.
- Check the deal and release payment after I accept the delivery.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
