cipher-x402-mcp
[CI]
[License: MIT]
[MCP]
[x402]
[MCPize]
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
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):
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)
Remote HTTP transport
Deployed at https://cipher-x402-mcp.vercel.app/mcp (streamable HTTP).
Probe the manifest at the root URL.
How payment works
- Agent calls (e.g.)
solana_wallet_scan({ "address": "..." }) without
a payment.
- 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.).
- Agent's wallet signs an EIP-3009 authorization for the advertised
maxAmountRequired.
- Agent re-invokes the same tool with
{ "address": "...", "_payment": "<base64-signed-header>" }.
- 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
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:
Deploy to Vercel
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 — three products, pay by card (Stripe) or crypto (Base USDC, Solana USDC, BTC):
- x402 Paid Endpoint Starter Kit — $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) — $9 — 150-page playbook covering trading, risk, security, architecture, revenue, compliance, and infra for solo Solana + x402 devs in 2026.
- Solana Bot Toolkit Walkthrough — $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 — 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]: <what you need> on this repo, or DM @[email protected]. 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
Niche x402 endpoints (non-crypto agent surfaces)
License
MIT — see LICENSE.