Solana Alpha X402 MCP Server

solana-alpha-x402-mcp

stdio MCP server for the Solana Alpha API (x402 v2, USDC on Solana mainnet).

One tool per paid HTTP endpoint, plus a free list_pricing tool. Each tool calls the live API at https://solana-x402-data.netlify.app (override with API_BASE_URL).

PayTo (never change): 3WN7T7VMnRJzjRhKosbaT2oiwuMiBCe6KBfZGiZygv7n

Behavior

• No SOLANA_PRIVATE_KEY: tools still call the live API. A 402 is returned as a readable JSON result (price, payTo, network, asset, feePayer) — not a hard failure — so agents can discover payment requirements.
• With SOLANA_PRIVATE_KEY: uses @x402/fetch + @x402/svm (ExactSvmScheme) to sign and settle USDC payments automatically. Optional MAX_PRICE_USDC rejects calls above the cap.
• This package is a standalone Node MCP server; it talks to the live Solana Alpha API over HTTPS and does not embed Netlify Functions.

Install (local / from this repo)

npm install
npm run smoke          # initialize + tools/list + get_price → 402 info (no key, no payment)

Published npm name (when published): solana-alpha-x402-mcp
Until then, point your MCP host at the local entry: node /absolute/path/to/solana-alpha-x402-mcp/src/index.mjs

Environment

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

With auto-pay (use a funded burner wallet only):

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "SOLANA_PRIVATE_KEY": "YOUR_BASE58_SECRET",
        "MAX_PRICE_USDC": "0.08",
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

After npm publish of this package you can use:

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"],
      "env": {
        "MAX_PRICE_USDC": "0.08"
      }
    }
  }
}

Cursor (mcp.json)

Project or user MCP config:

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

Or via npx once published:

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"]
    }
  }
}

Discovery (HTTP, free)

Public discovery documents on the live API host:

• /.well-known/mcp.json — server card / install command
• /tools.json — Claude/OpenAI-style function schemas (incl. price)
• /.well-known/agent.json
• /openapi.json
• /llms.txt

Safety

• Do not put a real funded key in git, screenshots, or chat logs.
• Smoke tests intentionally unset SOLANA_PRIVATE_KEY and never settle a payment.
• PayTo is a receive-only public address hard-coded to match the API; changing it would break settlement against the live service.