@blocklabs/shop-mcp

MCP server that lets any MCP-capable agent (Claude Desktop, Claude Code, etc.) search and buy from the BlockLabs x402 shop. Paid calls sign USDC payments automatically with the configured wallet; every payment is capped.

Tools

| Tool | Cost | What it does | |---|---|---| | shop_info | free | Health, live search price, accepted networks, active wallet | | search_products | ~$0.001/query | Typo-tolerant search over 300k+ products | | get_product | ~$0.001 | Full product detail by catalog id or SKU | | browse_categories | ~$0.001 | Category tree with live in-stock counts | | get_shipping_options | ~$0.001 | Carrier/cost/delay menu for a basket | | get_order_quote | free | Signed all-in USD quote (items + shipping + taxes) | | place_order | quote price | Quotes, enforces the budget, pays, places the order | | track_order | free | Order status, fulfillment ids, carrier tracking |

place_order always re-quotes first and refuses before signing when the quote exceeds maxUsd (per call) or MAX_ORDER_USD (server cap). The x402 client's own SpendControls enforce the same caps a second time at signing.

Environment

| Var | Default | Notes | |---|---|---| | SHOP_BASE_URL | https://shop.blocklabs.nl | | | X402_NETWORK | eip155:8453 | Base mainnet; use eip155:84532 against a testnet shop | | EVM_PRIVATE_KEY | – | Funded USDC wallet. Omit = free tools only | | MAX_SEARCH_USD | 0.01 | Per-search payment cap | | MAX_ORDER_USD | 50 | Per-order payment cap |

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "blocklabs-shop": {
      "command": "npx",
      "args": ["-y", "@blocklabs/shop-mcp@latest"],
      "env": {
        "EVM_PRIVATE_KEY": "0x...",
        "MAX_ORDER_USD": "25"
      }
    }
  }
}

Claude Code (.mcp.json in any project)

{
  "mcpServers": {
    "blocklabs-shop": {
      "command": "npx",
      "args": ["-y", "@blocklabs/shop-mcp@latest"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

Node >= 22 required. pnpm -C mcp test runs the hermetic suite (in-memory MCP transport against a mock shop, no chain/DB).