x4

x402 Dev Console

v1.0.0

Setup Guide

Connect x402 MCP servers to Claude Desktop or Cursor IDE to enable AI agents with payment capabilities.

What is x402 MCP Portal?

This portal hosts 18 MCP (Model Context Protocol) servers that enable AI assistants in Claude Desktop and Cursor IDE to interact with blockchain networks and execute payments using the x402 protocol.

Each MCP server provides specific tools and capabilities:

  • Payment Tools - Accept and process payments in USDC/SOL
  • Blockchain Data - Query Solana transactions, accounts, and programs
  • DeFi Integration - Access DEXs, lending protocols, price oracles
  • NFT & Token Tools - Manage tokens, NFTs, and DAOs
  • Analytics - Wallet tracking, sentiment analysis, market data

Prerequisites

1.
Deploy this portal to a hosting platform (Vercel, Render, etc.) - localhost URLs won't work with Claude/Cursor
2.
Install Claude Desktop or Cursor IDE
3.
Have npx installed (comes with Node.js)

Quick Start

Step 1: Deploy the Portal

Deploy this Next.js app to your preferred platform:

pnpm build
# Then deploy to Vercel, Render, or any Node.js host

Step 2: Update Server URLs

After deployment, update all MCP server URLs:

NEXT_PUBLIC_APP_URL=https://your-domain.com node scripts/update-server-urls.js

Step 3: Configure Your IDE

Add MCP servers to your IDE's configuration file:

For Cursor:

Settings → MCP → Edit in settings.json

For Claude Desktop:

Mac: ~/.config/claude/config.json
Windows: %APPDATA%\Claude\config.json

{
  "mcpServers": {
    "x402-payments": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://your-domain.com/api/mcp-server/x402-payments"
      ]
    }
  }
}

Step 4: Restart Your IDE

Fully restart Claude Desktop or Cursor to load the new MCP servers.

Step 5: Test the Connection

In your IDE, ask the AI:

"What MCP tools do you have access to?"

Available MCP Servers (18 Total)

Payment Servers (7):

  • • x402-payments
  • • premium-ai-models
  • • trading-signals
  • • ipfs-storage
  • • compute-engine
  • • market-data-stream
  • • api-gateway

Blockchain Servers (11):

  • • twitter-sentiment
  • • solana-data
  • • nft-metadata
  • • defi-protocols
  • • price-oracle
  • • wallet-analytics
  • • smart-contract-audit
  • • gas-optimizer
  • • dao-governance
  • • token-deployer
  • • bridge-aggregator

Need More Help?

For detailed setup instructions, troubleshooting, and advanced configuration:

View Complete Setup Guide on GitHub →
Browse All ServersBack to Home