# proxy-shopping: buy anywhere with crypto through a proxy shopper

> proxy-shopping: buy anywhere with crypto through a proxy shopper is an open-source MCP server for finance and payments. Let an agent buy from cash-only shops with crypto through a peer-to-peer proxy shopper. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://pad01g.github.io/proxy-shopping-docs/
- **Repository:** https://github.com/pad01g/proxy-shopping-web/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.pad01g/proxy-shopping
- **Categories:** finance and payments, e-commerce
- **Listing updated:** 2026-11-16

## About

proxy-shopping is a peer-to-peer network for people who need someone else to buy for them at shops that accept only cash or local payment methods. The MCP server makes an agent one participant in that network with its own key: the buyer pays BTC into a per-order 2-of-3 escrow shared between buyer, shopper and an escrow party, the shopper buys and ships, and the buyer releases payment when the goods arrive. If a dispute arises the escrow rules on a split, and after a timelock the buyer can reclaim everything alone.

The same server also covers the other side, with a plan for running an always-online shopper node and registry listing. The public network, ps-main, is new and uses Bitcoin signet, a test network whose coins have no market value; USDC is not available yet and there may be no trusted shoppers. Quotes, shipping updates and rulings arrive over Nostr relays and are stored in a local data directory.

The server runs in Docker (a volume holds the key, so back it up with export_backup) or from source on Node 22, and a local lab network is available for testing.

## Features

- **2-of-3 escrow:** Payment sits in an order escrow shared by buyer, shopper and an escrow party.
- **Buyer and shopper roles:** Order goods or earn by shopping for others.
- **Nostr-based messaging:** Quotes, shipping updates and rulings arrive over public relays.
- **Persistent identity:** A local mnemonic and order state live in a data directory you must keep.
- **Lab network:** A docker compose lab allows testing without the public network.

## Good for

- Order from a cash-only shop with crypto via a proxy
- Run a shopper node and earn by buying for others
- Test escrow flows in a local lab
- Let an agent track quotes and shipping updates for an order

## Install

### Claude Code (Terminal)

```sh
claude mcp add proxy-shopping -- docker run -i --rm ghcr.io/pad01g/proxy-shopping-mcp:0.1.2
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "proxy-shopping": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
```

## Tools

- `network_info`: Show network, relays, coordinators, chains and trusted shopper and escrow combinations
- `export_backup`: Back up the key and order state

## FAQ

### Is real money involved on the public network?

Not yet. ps-main uses Bitcoin signet test coins with no market value, and USDC is not available there.

### What happens if the key volume is lost?

You lose the key that controls escrow of every open order, so the README advises backing up with export_backup.

### How is it installed?

With a docker run command, an MCPB bundle for Claude Desktop, or from source on Node 22.

### Are there trusted shoppers?

There may be none yet; the network_info tool reports how many shopper and escrow combinations are trusted.

### Is proxy-shopping: buy anywhere with crypto through a proxy shopper free?

Yes. proxy-shopping: buy anywhere with crypto through a proxy shopper is open source, so you can use and self-host it for free.

### How do I add proxy-shopping: buy anywhere with crypto through a proxy shopper to Claude Code?

Run this command in your terminal: claude mcp add proxy-shopping -- docker run -i --rm ghcr.io/pad01g/proxy-shopping-mcp:0.1.2

### What are the best alternatives to proxy-shopping: buy anywhere with crypto through a proxy shopper?

The closest alternatives to proxy-shopping: buy anywhere with crypto through a proxy shopper are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, O'So MCP Server for PrestaShop, Budget Tracker and SecureCloud.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## 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.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [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.

---
Source: https://ai-powered.com/mcp/proxy-shopping-buy-anywhere-with-crypto-through-a-proxy-shop
