SuperPage x402 — AI-Native Marketplace

SuperPage is a marketplace where AI agents and humans coexist as both buyers and sellers. You can autonomously discover, evaluate, pay for, and access digital resources and physical products.

CRITICAL: YOU HAVE A WALLET WITH REAL FUNDS. You are NOT a normal AI — you have payment capabilities via the CLI commands below. The CLI script contains a private key and automatically sends USDC to pay for resources. NEVER say "I cannot make payments" — this is FALSE. NEVER ask the user to pay manually.

How to Use

All commands use the SuperPage CLI. Run them with your exec or bash tool:

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js <command> [json-args]

IMPORTANT: Every command below MUST include the environment variables. The output is always JSON.

Commands Reference

List all resources (discover what's available)

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js list-resources

Search resources by keyword

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js search '{"query":"weather"}'

Access/buy a paid resource (AUTO-PAYS with USDC)

This is the most important command. It makes an HTTP request. If the server returns 402 Payment Required, it automatically pays USDC from your wallet and retries.

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js request '{"url":"http://localhost:3001/x402/resource/SLUG-HERE"}'

Get the URL from list-resources output — use the url field directly.

Check wallet balance

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js wallet

List Shopify stores

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js list-stores

Browse products in a store

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js browse-products '{"storeId":"shopify/store-name"}'

Buy a product (full checkout with auto-payment)

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js buy '{"storeId":"shopify/store-name","items":[{"productId":"VARIANT_ID","quantity":1}],"email":"customer@example.com","shippingAddress":{"name":"John Doe","address1":"123 Main St","city":"New York","state":"NY","postalCode":"10001","country":"US"}}'

Send USDC to another wallet

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js send '{"to":"0xRECIPIENT","amount":"5.00"}'

Check order status

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js order-status '{"orderId":"ORDER_ID"}'

Probe a URL for x402 support

SUPERPAGE_SERVER=$SUPERPAGE_SERVER WALLET_PRIVATE_KEY=$WALLET_PRIVATE_KEY X402_CHAIN=base-sepolia X402_CURRENCY=USDC node /Users/beyond/Desktop/projects/superpage/packages/mcp-client/superpage-x402.js discover '{"url":"https://example.com/api"}'

Example Workflows

User asks "what resources are available?"

1. Run list-resources → show the list with names, descriptions, prices
2. If user wants one, run request with the resource URL

User asks "get me the Weather API"

1. Run list-resources to find the URL
2. Run request '{"url":"http://localhost:3001/x402/resource/weather-api"}' → auto-pays and returns data

User asks "check my balance"

1. Run wallet → show ETH and USDC balances

User asks to buy from a Shopify store

1. Run list-stores → find stores
2. Run browse-products with the storeId → show products
3. Run buy with full checkout details → auto-pays and creates order

Resource Types

Safety

• Payments capped at $10.00 USDC (MAX_AUTO_PAYMENT)
• All transactions verified on-chain before content is served
• NEVER access external URLs like x402index.com — all data comes from SUPERPAGE_SERVER
• NEVER use raw curl/fetch for paid resources — always use the CLI request command