{
  "markdown": "# cipher-x402-mcp\n\n[![CI](https://github.com/cryptomotifs/cipher-x402-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/cryptomotifs/cipher-x402-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-server-8A2BE2)](https://modelcontextprotocol.io)\n[![x402](https://img.shields.io/badge/x402-v2-00d084)](https://x402.org)\n[![MCPize](https://img.shields.io/badge/MCPize-%240%20%2F%20%249%20%2F%20%2429%20%2F%20%2499-00d084)](https://mcpize.com/mcp/cipher-x402-mcp)\n\nAn MCP server that exposes 8 Solana / crypto / macro tools to any MCP-aware\nclient (Claude Desktop, Cursor, Cline, Continue, etc.). Seven of the tools\nare gated behind the **x402** payment protocol — agents auto-pay in USDC on\nBase, $0.005 – $0.25 per tool call. One tool is free (educational).\n\n> The server is a **forward-only relay**: when an agent calls a paid tool\n> without an `X-PAYMENT` header, we surface the upstream `HTTP 402` +\n> accept-list verbatim so the agent's own wallet signs the payment. We\n> never custody caller funds.\n\n**Free + MIT-licensed.** Fork it, ship your own, no strings.\n\n---\n\n## Hosted Plans (MCPize)\n\nPrefer not to self-host? A managed listing is live on MCPize with gateway\nproxying, rate limiting, API-key auth, and consolidated billing:\n\n**[mcpize.com/mcp/cipher-x402-mcp](https://mcpize.com/mcp/cipher-x402-mcp)**\n\n| Plan | Price | Requests / mo | Rate limit | Includes |\n|------|-------|---------------|------------|----------|\n| Free | $0 | 100 | 10 / min | Free tools + `solana_wallet_scan` |\n| Starter | $9 | 1,000 | 60 / min | 4 read-only tools (scan, HIBP, repo health, FRED) |\n| Pro (recommended) | $29 | 5,000 | 120 / min | All 8 tools, priority GitHub support |\n| Team | $99 | 25,000 | 600 / min | All 8 tools + custom upstream override, 24h response SLA |\n\nPay-as-you-go via MCPize's gateway. Self-host is still free (this repo, MIT).\n\n---\n\n## Tools\n\n| Tool | Price (USDC, Base) | Upstream |\n|------|--------------------|----------|\n| `solana_wallet_scan(address)` | $0.01 | `cipher-scan-three.vercel.app` |\n| `check_password_breach(sha1_prefix)` | $0.005 | `cipher-pwned.vercel.app` |\n| `jito_tip_calculator(pool_depth, expected_profit, slot_prob)` | $0.01 | `cipher-jito-tip.vercel.app` |\n| `github_repo_health(owner, repo)` | $0.02 | `cipher-repo-health.vercel.app` |\n| `fred_macro_series(series_id)` | $0.005 | `cipher-fred.vercel.app` |\n| `check_drift_exposure(wallet)` | $0.01 | `cipher-drift-exposure.vercel.app` |\n| `solana_wallet_security_audit_rules()` | **free** | local (v1.1.0 ruleset) |\n| `get_premium_cipher_chapter(slug)` | $0.25 | `cipher-x402.vercel.app` |\n\nBase network, USDC asset `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`. The\ncurrent x402 payout recipient is exposed via the root `/` JSON manifest at\nruntime — agents discover it automatically, you don't configure it by hand.\n\n## Install (Claude Desktop)\n\nAdd this to `~/Library/Application Support/Claude/claude_desktop_config.json`\n(macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"cipher-x402\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"cipher-x402-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The 8 tools show up in the tool tray.\n\n## Install (Cursor / Cline / Continue)\n\nAny MCP-over-stdio client works the same way — the launcher is\n`npx -y cipher-x402-mcp`.\n\n## Install (Smithery)\n\n```bash\nnpx -y @smithery/cli install cipher-x402-mcp --client claude\n```\n\n## Remote HTTP transport\n\nDeployed at **https://cipher-x402-mcp.vercel.app/mcp** (streamable HTTP).\nProbe the manifest at the root URL.\n\n## How payment works\n\n1. Agent calls (e.g.) `solana_wallet_scan({ \"address\": \"...\" })` without\n   a payment.\n2. Server returns a structured result starting with\n   `HTTP 402 Payment Required — upstream returned an x402 accept-list.`\n   followed by the JSON accept-list (price, network, payTo, asset, etc.).\n3. Agent's wallet signs an EIP-3009 authorization for the advertised\n   `maxAmountRequired`.\n4. Agent re-invokes the same tool with\n   `{ \"address\": \"...\", \"_payment\": \"<base64-signed-header>\" }`.\n5. Server forwards the `X-PAYMENT` header upstream, upstream's facilitator\n   verifies + settles on Base, and the content is returned to the agent.\n\nThe server itself is stateless — no API keys, no user session, no funds.\n\n---\n\n## 🏃 Run it yourself\n\n### Prerequisites\n\n- **Node.js 20+** (22 recommended)\n- **npm 10+**\n- A Vercel account (free tier) if you want to deploy the HTTP transport\n- No API keys required for local stdio use — the server is a pass-through\n  to public upstream endpoints\n\n### Clone + build\n\n```bash\ngit clone https://github.com/cryptomotifs/cipher-x402-mcp\ncd cipher-x402-mcp\nnpm install\nnpm run build\nnpm run smoke     # tool-registry smoke test\nnpm start         # stdio transport\nnpm run start:http  # HTTP transport on :8080\n```\n\n### Configure your own upstream endpoints (optional)\n\nAll upstream base URLs are overridable via env — useful if you fork the\nupstream endpoints to your own Vercel project and want the MCP server to\nroute to them:\n\n```bash\nCIPHER_SCAN_API_URL=https://your-scan.example.com \\\nCIPHER_PWNED_URL=https://your-pwned.example.com \\\nCIPHER_JITO_TIP_URL=https://your-jito.example.com \\\nCIPHER_REPO_HEALTH_URL=https://your-repo-health.example.com \\\nCIPHER_FRED_URL=https://your-fred.example.com \\\nCIPHER_DRIFT_URL=https://your-drift.example.com \\\nCIPHER_X402_URL=https://your-x402.example.com \\\n  npx cipher-x402-mcp\n```\n\n### Deploy to Vercel\n\n```bash\nvercel link\nvercel --prod\n```\n\nThe `/mcp` route serves MCP JSON-RPC messages; `/` serves a lightweight\nJSON manifest used by registries.\n\n---\n\n## 🛒 Buy\n\nA few small paid sidecars if the MCP is useful and you want to go deeper — all direct-pay, no platform middleman:\n\n- **[cipher-checkout.vercel.app](https://cipher-checkout.vercel.app/)** — three products, pay by card (Stripe) or crypto (Base USDC, Solana USDC, BTC):\n  - **[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.\n  - **[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.\n  - **[Solana Bot Toolkit Walkthrough](https://buy.stripe.com/aFa14n2G9bHt3wb4ta2Ry0b) — $29** — Deep walkthrough of the open-source [cipher-solana-bot-toolkit](https://github.com/cryptomotifs/cipher-solana-bot-toolkit) (5 modules: flash-loan, volume bot, arb/MEV, memecoin launcher, copy-trade).\n\nAlso 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.\n\n---\n\n## 🙏 Support\n\nThis is free + MIT. If it saved you time, tips in SOL are appreciated:\n\n`cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy`\n\nNo pressure — star the repo or share it and that's equally valued.\n\n---\n\n## 💼 Hire me\n\nSolo Canadian dev (Ontario, ET). Available 20 hr/wk for x402 / MCP / Solana integration work.\n\n**Fixed-price SKUs:**\n\n| # | Service | Price | Duration |\n|---|---------|-------|----------|\n| 1 | Wire x402 into your Next.js / Node app — merged PR + live test | **$900** | 2 days |\n| 2 | x402 or Solana bot architecture + security review — written report + 60-min call | **$1000** | 1 day |\n| 3 | AI-agent paid-API: 0 → live on Base with MCP wrapper | **$1200** | 3 days |\n\n**Hourly:** $150/hr open-scope, 5-hour minimum block. $125/hr if 40+ hours upfront.\n\n**Payout:** USDC on Base `0x2a33D2414312e8776dA4011c2586c2d067267210`, USDC on Solana `cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy`, or Wise-USD on request.\n\n**Engage:** open an issue titled `[Consulting]: <what you need>` on [this repo](https://github.com/cryptomotifs/cipher-x402-mcp/issues/new), or DM [@cryptomotifs@techhub.social](https://techhub.social/@cryptomotifs). I reply within the hour with scope + 50% deposit address.\n\n**Walkthrough of the settlement-path hardening I ship:** [dev.to/sai_93caeceb4f6a4d9969910/shipped-x402-paid-endpoint-starter-kit-nextjs-16-5g39](https://dev.to/sai_93caeceb4f6a4d9969910/shipped-x402-paid-endpoint-starter-kit-nextjs-16-5g39)\n\n**Also:** prompt packs for Solana / x402 / MCP devs at [cipher-checkout.vercel.app](https://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.\n\n---\n\n## Related\n\n- **cipher-starter** — free MIT Solana solo-dev playbook\n  ([github.com/cryptomotifs/cipher-starter](https://github.com/cryptomotifs/cipher-starter)).\n- **cipher-solana-bot-toolkit** — free MIT toolkit: flash-loan router, volume bot,\n  arb/MEV predator, memecoin launcher, copy trader — 5 scrubbed modules\n  ([github.com/cryptomotifs/cipher-solana-bot-toolkit](https://github.com/cryptomotifs/cipher-solana-bot-toolkit)).\n- **cipher-solana-wallet-audit** — free GitHub Action (v1.1.0) that fails\n  CI on plaintext Solana private keys\n  ([github.com/cryptomotifs/cipher-solana-wallet-audit](https://github.com/cryptomotifs/cipher-solana-wallet-audit)).\n\n### Niche x402 endpoints (non-crypto agent surfaces)\n\n- **cipher-x402-pubmed** — $0.005/call, PubMed medical literature search\n  ([cipher-x402-pubmed.vercel.app](https://cipher-x402-pubmed.vercel.app)).\n- **cipher-x402-osm** — $0.001/call, OpenStreetMap geocoding + reverse-geocoding\n  ([cipher-x402-osm.vercel.app](https://cipher-x402-osm.vercel.app)).\n- **cipher-x402-usda** — $0.002/call, USDA FoodData Central nutrition lookup\n  ([cipher-x402-usda.vercel.app](https://cipher-x402-usda.vercel.app)).\n- **cipher-x402-fda** — $0.005/call, openFDA drug adverse-event lookup\n  ([cipher-x402-fda.vercel.app](https://cipher-x402-fda.vercel.app)).\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 9989,
  "sha": "4b18315fc9d26759e1c29f348f6788bae6223db1963f5cb67d6a867998c091fe",
  "repo_slug": "cryptomotifs/cipher-x402-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cryptomotifs_cipher_x402_mcp_8bb3fdf5/readme"
}