{ "markdown": "\n\n# 💧 Spraay x402 MCP Server\n\n[![smithery badge](https://smithery.ai/badge/Plagtech/Spraay-x402-mcp)](https://smithery.ai/servers/Plagtech/Spraay-x402-mcp)\n![Version](https://img.shields.io/badge/version-4.3.0-blue)\n![Tools](https://img.shields.io/badge/tools-183-blueviolet)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Full-stack DeFi infrastructure for AI agents — 183 pay-per-call tools, backed by the 192-endpoint Spraay x402 Gateway on Base, with Solana, Ethereum, XRP, and Stellar payment rails.**\n\nConnect Claude, Cursor, or any MCP client to onchain payments, batch payouts,\nswaps, bridging, payroll, invoicing, escrow, oracle data, analytics, 200+ AI\nmodels, GPU/compute, research APIs, search/RAG, and more. Agents pay USDC per\nrequest via the [x402 protocol](https://x402.org) — no API keys, no accounts.\n\n> The tool list is generated from the live gateway manifest at build time\n> (`npm run sync`), so the authoritative catalog and pricing always live at the\n> gateway — see [Tool catalog](#tool-catalog). 24 of the gateway's endpoints are\n> **free** (no payment required).\n\n---\n\n## Quick Start\n\nInstall and go — **no config, no API keys, no env vars.** On first run the\nserver auto-creates a wallet, saves it to `~/.spraay/.session`, and prints the\naddress to stderr. Fund that address with USDC on Base and start calling tools.\n\n**Read [Security & Wallet Safety](#security--wallet-safety) — these tools move\nreal funds.**\n\n### One-line install (Claude Code)\n\n```bash\nclaude mcp add spraay -s user -- npx -y spraay-x402-mcp\n```\n\n### Manual config (Cursor / Claude Desktop)\n\n**Cursor** (`.cursor/mcp.json`) or **Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"spraay\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"spraay-x402-mcp\"]\n }\n }\n}\n```\n\nThat's it. The first run prints something like:\n\n```\n💧 Spraay created a new wallet: 0xABC…123\n Private key saved to ~/.spraay/.session (keep it safe — it controls funds).\n Fund this address with USDC on Base to start paying for tool calls.\n```\n\n#### Optional — bring your own wallet\n\nTo sign with a key you already control instead of the auto-created one, set\n`EVM_PRIVATE_KEY` in your environment (it overrides the session wallet).\n**Never paste a raw key into a committed config file** — use a dedicated hot\nwallet funded only with what the agent may spend. See\n[Security & Wallet Safety](#security--wallet-safety).\n\n### Remote URL (no wallet on your machine)\n\nSettlement is handled gateway-side; your client never holds a signing key.\n\n```json\n{\n \"mcpServers\": {\n \"spraay\": {\n \"url\": \"https://spraay-x402-mcp--plagtech.run.tools\"\n }\n }\n}\n```\n\n### Smithery\n\n```bash\nsmithery mcp add Plagtech/Spraay-x402-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/plagtech/spraay-x402-mcp\ncd spraay-x402-mcp\nnpm install\nnpm run build\nnpm start # auto-creates a wallet on first run\n```\n\n---\n\n## Tool catalog\n\n183 tools spanning the gateway's 33 categories. Highlights by area:\n\n| Area | What it covers |\n| --- | --- |\n| **AI & Inference** | 200+ LLMs (OpenAI-compatible), wallet/tx classification, contract explanation, summaries |\n| **Compute** | Text / image / video / TTS / STT / embeddings across Replicate, Chutes, OpenRouter; batch jobs |\n| **Compute Futures** | Prepaid compute credits with tier discounts; draw down per inference |\n| **Bittensor** | Decentralized inference, image gen, and embeddings via SN64 / SN19 |\n| **Payments** | Batch payouts up to 200 recipients (Base, XRP Ledger, Stellar); estimates |\n| **Payroll** | Stablecoin payroll runs across Base, Ethereum, Solana |\n| **Invoicing & Escrow** | Crypto-native invoices and milestone escrow (persistent) |\n| **DeFi & Data** | Swaps (Uniswap V3 / Aerodrome), oracle prices/gas/FX, bridge quotes, balances, ENS/Basename |\n| **Analytics** | Wallet profiles and decoded transaction history |\n| **Research** | 250M+ papers (OpenAlex), arXiv, Crossref, PubMed, PubChem, US Census, dictionary |\n| **Search & RAG** | Web search, content extraction, question answering |\n| **Communication** | Email, SMS, XMTP messaging, webhooks |\n| **Infrastructure** | Multi-chain RPC, IPFS/Arweave storage, cron scheduling, structured logs |\n| **Identity & Compliance** | KYC/sanctions screening, auth sessions, audit trail, crypto tax (FIFO, IRS 8949) |\n| **Supply Chain (SCTP)** | Supplier registration, purchase orders, invoice verification, settlement |\n| **Robotics (RTP)** | Register robots, dispatch paid tasks, escrow-backed completion |\n| **Trust & Safety** | ProofLayer trust scores; free token-safety, address-safety, and tx-decode checks |\n\n**24 free endpoints** require no payment — gas/prices/chain-status, address &\nbatch validation, ENS resolution, unit conversion, x402 discovery probes, and\nmodel/compute discovery.\n\nFor the exact, current tool list and per-tool pricing, query the live manifest:\n\n```bash\ncurl https://gateway.spraay.app/.well-known/x402.json\n```\n\nPricing ranges from $0.001 (reads) to ~$0.10 (payroll, escrow release, tax),\nsettled in USDC on Base.\n\n---\n\n## How it works\n\n1. An agent calls a tool (e.g. `spraay_batch_execute`).\n2. The MCP server hits the [Spraay x402 Gateway](https://gateway.spraay.app).\n3. The gateway responds `402 Payment Required` with a USDC amount.\n4. **Remote mode:** settlement is handled gateway-side.\n **Local mode:** `@x402/axios` signs a USDC micropayment from the auto-created\n (or overridden) wallet.\n5. The gateway validates payment and returns the data.\n\n---\n\n## Security & Wallet Safety\n\nThese tools can initiate **real USDC payments**. Treat the server like any tool\nwith funds access.\n\n- **The auto-created wallet only holds what you send it.** Fund it with only as\n much USDC as you're willing to let the agent spend. It starts empty, so a fresh\n install cannot move funds until you fund it; read-only tools work regardless.\n- **The session key lives at `~/.spraay/.session`.** Protect that file like any\n secret — anyone who reads it controls the wallet. It's written with `0600`\n permissions on POSIX systems. Back it up if the funds matter; delete it to\n rotate to a new wallet on the next run.\n- **Prefer the remote URL** if you'd rather keep no signing key on your machine —\n settlement is handled gateway-side.\n- If you bring your own key via `EVM_PRIVATE_KEY`, use a **dedicated hot wallet**\n that controls no other assets, and **never** put a raw private key in a config\n file, issue, or any committed file — keep it in your shell environment only.\n\nThe published npm package ships only `dist/`, `README`, and `LICENSE` (verify\nwith `npm pack --dry-run`) — no binaries, no build tooling, no install scripts.\n\nReport security issues to **security@spraay.app**, not a public issue.\n\n---\n\n## Requirements\n\n- **Node.js** 20+\n- **MCP client** — Claude Desktop, Cursor, or any MCP-compatible client\n- **USDC on Base** — fund the auto-created wallet (or your own); even $1 covers\n thousands of calls\n\n## Environment variables\n\nNone are required — the server runs with zero configuration. All of the\nfollowing are optional overrides.\n\n| Variable | Required | Default | Description |\n| --- | --- | --- | --- |\n| `EVM_PRIVATE_KEY` | No | auto-created at `~/.spraay/.session` | Override the auto-created wallet with your own key. Use a dedicated, funded-as-needed hot wallet. |\n| `SPRAAY_GATEWAY_URL` | No | `https://gateway.spraay.app` | Override the gateway URL. |\n\n---\n\n## Links\n\n- **MCP server:** [mcp.spraay.app](https://mcp.spraay.app)\n- **Gateway:** [gateway.spraay.app](https://gateway.spraay.app)\n- **Manifest:** [gateway.spraay.app/.well-known/x402.json](https://gateway.spraay.app/.well-known/x402.json)\n- **Smithery:** [smithery.ai/servers/Plagtech/Spraay-x402-mcp](https://smithery.ai/servers/Plagtech/Spraay-x402-mcp)\n- **x402:** [x402.org](https://x402.org)\n\n## License\n\nMIT\n", "bytes": 9036, "sha": "8af855c13434e7b2331ba029fae69a2df6157026318cb5bce1170c8c9db7dc14", "repo_slug": "plagtech/spraay-x402-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_plagtech_spraay_x402_mcp_701241a9/readme" }