X402 Solana MCP Server

x402-solana

Paid x402 API tools for AI agents, settled in USDC on Solana (mainnet). A Solana-rail replica of x402-endpoints (Base): same FastAPI quality, same CDP facilitator — payments routed on Solana instead of Base.

• No API key — payment is authentication.
• Gasless for the buyer — the CDP facilitator is the transaction fee payer.
• USDC mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (6 decimals), network solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.

Endpoints (10)

Discovery: /.well-known/x402.json, /.well-known/agent-card.json, /llms.txt. Health: /health.

Run locally

python3.12 -m venv .venv
./.venv/bin/pip install -r requirements.txt
# set env (see .env.example) — CDP keys required for the facilitator
./.venv/bin/uvicorn app.main:app --port 8000

Deploy (Render)

One-click via render.yaml (Blueprint). Set the sync:false secrets (CDP_API_KEY_ID, CDP_API_KEY_SECRET, RECEIPT_SIGNING_SEED, optional ANTHROPIC_API_KEY) in the dashboard.

Architecture

Payment layer is 100% in app/main.py (register_exact_svm_server + PaymentOption(network=solana…)); endpoint handlers in app/routers/ are payment-agnostic. Description ≤ 500 chars is enforced at startup (hard CDP /verify constraint). See DIFFERENCES-BASE-SOLANA.md for the full Base→Solana map.

Tooling (tools/)

• check_facilitator.py — verify the CDP facilitator advertises Solana support.
• lint_descriptions.py — English-only + ≤500-char lint.
• gen_discovery.py — regenerate the discovery files from the routes.
• create_seller_ata.py — create the seller USDC ATA (settlement prerequisite).
• settle.py — buyer→endpoint settlement (dry by default, --execute to pay).