CIPHER x402 — Paid Solana & Crypto Tools

cipher-x402-mcp

An MCP server that exposes 8 Solana / crypto / macro tools to any MCP-aware client (Claude Desktop, Cursor, Cline, Continue, etc.). Seven of the tools are gated behind the x402 payment protocol — agents auto-pay in USDC on Base, $0.005 – $0.25 per tool call. One tool is free (educational).

The server is a forward-only relay: when an agent calls a paid tool

without an X-PAYMENT header, we surface the upstream HTTP 402 +

accept-list verbatim so the agent's own wallet signs the payment. We

never custody caller funds.

Free + MIT-licensed. Fork it, ship your own, no strings.

---

Hosted Plans (MCPize)

Prefer not to self-host? A managed listing is live on MCPize with gateway proxying, rate limiting, API-key auth, and consolidated billing:

[mcpize.com/mcp/cipher-x402-mcp](https://mcpize.com/mcp/cipher-x402-mcp)

Pay-as-you-go via MCPize's gateway. Self-host is still free (this repo, MIT).

---

Tools

Base network, USDC asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. The current x402 payout recipient is exposed via the root / JSON manifest at runtime — agents discover it automatically, you don't configure it by hand.

Install (Claude Desktop)

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

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

Restart Claude Desktop. The 8 tools show up in the tool tray.

Install (Cursor / Cline / Continue)

Any MCP-over-stdio client works the same way — the launcher is npx -y cipher-x402-mcp.

Install (Smithery)

npx -y @smithery/cli install cipher-x402-mcp --client claude

Remote HTTP transport

Deployed at https://cipher-x402-mcp.vercel.app/mcp (streamable HTTP). Probe the manifest at the root URL.

How payment works

1. Agent calls (e.g.) solana_wallet_scan({ "address": "..." }) without a payment.
2. Server returns a structured result starting with HTTP 402 Payment Required — upstream returned an x402 accept-list. followed by the JSON accept-list (price, network, payTo, asset, etc.).
3. Agent's wallet signs an EIP-3009 authorization for the advertised maxAmountRequired.
4. Agent re-invokes the same tool with { "address": "...", "_payment": " " }.
5. Server forwards the X-PAYMENT header upstream, upstream's facilitator verifies + settles on Base, and the content is returned to the agent.

The server itself is stateless — no API keys, no user session, no funds.

---

🏃 Run it yourself

Prerequisites

• Node.js 20+ (22 recommended)
• npm 10+
• A Vercel account (free tier) if you want to deploy the HTTP transport
• No API keys required for local stdio use — the server is a pass-through to public upstream endpoints

Clone + build

git clone https://github.com/cryptomotifs/cipher-x402-mcp

cd cipher-x402-mcp npm install npm run build npm run smoke # tool-registry smoke test npm start # stdio transport npm run start:http # HTTP transport on :8080

Configure your own upstream endpoints (optional)

All upstream base URLs are overridable via env — useful if you fork the upstream endpoints to your own Vercel project and want the MCP server to route to them:

CIPHER_SCAN_API_URL=https://your-scan.example.com \

CIPHER_PWNED_URL=https://your-pwned.example.com \ CIPHER_JITO_TIP_URL=https://your-jito.example.com \ CIPHER_REPO_HEALTH_URL=https://your-repo-health.example.com \ CIPHER_FRED_URL=https://your-fred.example.com \ CIPHER_DRIFT_URL=https://your-drift.example.com \ CIPHER_X402_URL=https://your-x402.example.com \ npx cipher-x402-mcp

Deploy to Vercel

vercel link

vercel --prod

The /mcp route serves MCP JSON-RPC messages; / serves a lightweight JSON manifest used by registries.

---

🛒 Buy

A few small paid sidecars if the MCP is useful and you want to go deeper — all direct-pay, no platform middleman:

• [cipher-checkout.vercel.app](https://cipher-checkout.vercel.app/) — three products, pay by card (Stripe) or crypto (Base USDC, Solana USDC, BTC):
• [x402 Paid Endpoint Starter Kit](https://buy.stripe.com/9B6cN55SlfXJ4Af9Nu2Ry09) — $19 — Next.js 16 starter repo + 7-page tutorial PDF + one-command Vercel deploy. Working x402 endpoint that verifies X-PAYMENT against the facilitator.
• [Solana Solo-Dev Playbook (PDF)](https://buy.stripe.com/9B6aEX94xh1NgiXaRy2Ry0a) — $9 — 150-page playbook covering trading, risk, security, architecture, revenue, compliance, and infra for solo Solana + x402 devs in 2026.
• [Solana Bot Toolkit Walkthrough](https://buy.stripe.com/aFa14n2G9bHt3wb4ta2Ry0b) — $29 — Deep walkthrough of the open-source cipher-solana-bot-toolkit (5 modules: flash-loan, volume bot, arb/MEV, memecoin launcher, copy-trade).

Also available as a managed MCPize listing: [mcpize.com/mcp/cipher-x402-mcp](https://mcpize.com/mcp/cipher-x402-mcp) — Free / $9 / $29 / $99 per month.

---

🙏 Support

This is free + MIT. If it saved you time, tips in SOL are appreciated:

cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy

No pressure — star the repo or share it and that's equally valued.

---

💼 Hire me

Solo Canadian dev (Ontario, ET). Available 20 hr/wk for x402 / MCP / Solana integration work.

Fixed-price SKUs:

Hourly: $150/hr open-scope, 5-hour minimum block. $125/hr if 40+ hours upfront.

Payout: USDC on Base 0x2a33D2414312e8776dA4011c2586c2d067267210, USDC on Solana cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy, or Wise-USD on request.

Engage: open an issue titled [Consulting]: on this repo, or DM @cryptomotifs@techhub.social. I reply within the hour with scope + 50% deposit address.

Walkthrough of the settlement-path hardening I ship: dev.to/sai_93caeceb4f6a4d9969910/shipped-x402-paid-endpoint-starter-kit-nextjs-16-5g39

Also: prompt packs for Solana / x402 / MCP devs at cipher-checkout.vercel.app — 5 packs covering Anchor audit, x402 + MCP design, Solana bot engineering, crypto dev productivity, and a 20%-off bundle. Card or crypto.

---

Related

• cipher-starter — free MIT Solana solo-dev playbook (github.com/cryptomotifs/cipher-starter).
• cipher-solana-bot-toolkit — free MIT toolkit: flash-loan router, volume bot, arb/MEV predator, memecoin launcher, copy trader — 5 scrubbed modules (github.com/cryptomotifs/cipher-solana-bot-toolkit).
• cipher-solana-wallet-audit — free GitHub Action (v1.1.0) that fails CI on plaintext Solana private keys (github.com/cryptomotifs/cipher-solana-wallet-audit).

Niche x402 endpoints (non-crypto agent surfaces)

• cipher-x402-pubmed — $0.005/call, PubMed medical literature search (cipher-x402-pubmed.vercel.app).
• cipher-x402-osm — $0.001/call, OpenStreetMap geocoding + reverse-geocoding (cipher-x402-osm.vercel.app).
• cipher-x402-usda — $0.002/call, USDA FoodData Central nutrition lookup (cipher-x402-usda.vercel.app).
• cipher-x402-fda — $0.005/call, openFDA drug adverse-event lookup (cipher-x402-fda.vercel.app).

License

MIT — see LICENSE.