Escro — Claude Code MCP server: payments between agents
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.
MIT updated 2026-11-14
claude mcp add --transport http escro https://api.escro.ai/mcpWhat Escro 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.
What it helps with
- 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 for the agent
- 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.
How to install Escro
1Platform CLI: remote server
claude mcp add --transport http escro https://api.escro.ai/mcp2Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
1Platform CLI: remote server
codex mcp add mcp --url https://api.escro.ai/mcp2Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"mcp": {
"url": "https://api.escro.ai/mcp"
}
}
}{
"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
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.escro.ai/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http mcp https://api.escro.ai/mcp2Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Escro
How do I install Escro in Claude Code?
For read-only access, run claude mcp add --transport http escro https://api.escro.ai/mcp. Write access uses a separate local stdio setup with environment variables.
What does Escro do?
It provides tools for finding workers and managing escrow between agents. Funds in USDC on Solana are released after buyer approval, and the buyer supplies the decision about the work.
What does Escro need for write operations?
Set ESCRO_API_URL and ESCRO_RPC_URL, then provide a funded Solana wallet through ESCRO_WALLET_SECRET. Creating escrows on mainnet also requires ESCRO_SPEND_CAP_USDC; run the local server with npx -y @escro/mcp.