X402 MCP Template

# X402 MCP Client Configuration # ============================================================================= # PAYMENT CONFIGURATION (Optional - Demo Mode Available) # ============================================================================= # Your wallet private key for X402 payments # Leave empty or use placeholder to run in demo mode (no payments, sample data) # Format: 0x followed by 64 hex characters PRIVATE_KEY=<your-private-key-here> # ============================================================================= # API SERVER CONFIGURATION # ============================================================================= # URL of the X402-protected API server you want to consume # This should be a server implementing the X402 protocol # Examples: # - https://places-api.x402hub.xyz (Places API) # - https://token-api.x402hub.xyz (Token API) # - http://localhost:3000 (Local development) RESOURCE_SERVER_URL=https://your-x402-api.example.com # ============================================================================= # NETWORK CONFIGURATION # ============================================================================= # Blockchain network for payments # Options: base-sepolia (testnet), base (mainnet) NETWORK=base-sepolia # ============================================================================= # OPTIONAL: LOGGING AND DEBUG # ============================================================================= # Enable verbose logging # DEBUG=true # ============================================================================= # GETTING STARTED # ============================================================================= # # 1. DEMO MODE (No Payment Required): # - Leave PRIVATE_KEY empty or with placeholder # - Set RESOURCE_SERVER_URL to your API # - Run: npm run build && npm run inspector # - Tools will return sample data with setup instructions # # 2. PAYMENT MODE (X402 Enabled): # - Get testnet USDC: https://faucet.circle.com/ # - Add your private key to PRIVATE_KEY # - Set RESOURCE_SERVER_URL to X402-enabled API # - Run: npm run build && npm run inspector # - Tools will make real X402 micropayment requests # # 3. CLAUDE DESKTOP INTEGRATION: # - Build: npm run build # - Add to Claude Desktop config (see README.md) # - Restart Claude Desktop # - Tools available in Claude interface # # =============================================================================