npm.io
1.3.0 • Published 5h agoCLI

@blocklabs/shop-mcp

Licence
MIT
Version
1.3.0
Deps
5
Size
38 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

@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).

Keywords

mcpx402usdcagent-commerceshoppingdropshipping