Skip to content
MCP server

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

Let an agent buy from cash-only shops with crypto through a peer-to-peer proxy shopper

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.2
Listing updated
1 day ago

About 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. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proxy-shopping": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/proxy-shopping-mcp:0.1.2"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PS_NETWORKps-main (the public network: Nostr relays, BTC signet) or lab (the local docker compose lab)
  • PS_DATA_DIRDirectory of the mnemonic and order state inside the container; mount a volume there
  • PS_LAB_URLLab only: the lab demo server as seen from the container
  • PS_CONFIG_URLOptional URL of a web-app config.json (relays, coordinators, chains) that overrides the network preset

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Prices change. Check pad01g.github.io before you buy.

proxy-shopping: buy anywhere with crypto through a proxy shopper 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.

Alternatives to proxy-shopping: buy anywhere with crypto through a proxy shopper

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  4. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  6. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce