Spraay X402 Mcp

io.github.plagtechPublished by GitHub account plagtechv3.1.1Updated Oct 28, 2026

MCP server for Spraay x402 Gateway. 60 tools for crypto payments, DeFi, and AI on Base.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceAI & ML

Overview

AI-generated overview

Spraay x402 gateway server giving an assistant pay-per-call crypto, DeFi, AI inference, research and search tools on Base, paid in USDC.

What you can do
  • Call AI and compute tools: 200+ LLMs, image, video, TTS, STT, embeddings, batch jobs, Bittensor inference
  • Move funds: batch payouts, stablecoin payroll, invoicing, milestone escrow
  • Query DeFi and chain data: swaps, oracle prices, gas, bridge quotes, balances, ENS, wallet analytics
  • Use research and search: papers, arXiv, PubMed, web search, content extraction, question answering
  • Reach infrastructure and compliance: multi-chain RPC, IPFS/Arweave storage, cron, KYC and sanctions screening, crypto tax
  • Send email, SMS and XMTP messages, and run supply-chain and robotics task flows
When to use it
Useful when an assistant needs onchain payments, DeFi data, paid AI inference or research APIs without managing separate provider accounts and API keys, and you are comfortable letting it spend small USDC amounts per call. Read-only and free endpoints work without funding.
Requirements
Node.js 20+ and an MCP client for the local npm package, or the remote URL instead. USDC on Base to fund the wallet for paid calls; the server auto-creates a wallet at ~/.spraay/.session on first run. Optional overrides: EVM_PRIVATE_KEY and SPRAAY_GATEWAY_URL. Network access to the gateway.
Before you install
Tools can move real USDC: payouts, payroll, escrow and swaps. Fund the wallet only with what the agent may spend, and protect the session key file, which controls the funds. If using EVM_PRIVATE_KEY, use a dedicated hot wallet and never commit the key. The remote URL avoids holding a signing key locally. Tool calls and payment details go to the Spraay gateway.

Installation

In SourceWeft

  1. Open Spraay X402 Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

💧 Spraay x402 MCP Server

[smithery badge] [Version] [Tools] [License: MIT]

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.

Connect Claude, Cursor, or any MCP client to onchain payments, batch payouts, swaps, bridging, payroll, invoicing, escrow, oracle data, analytics, 200+ AI models, GPU/compute, research APIs, search/RAG, and more. Agents pay USDC per request via the x402 protocol — no API keys, no accounts.

The tool list is generated from the live gateway manifest at build time (npm run sync), so the authoritative catalog and pricing always live at the gateway — see Tool catalog. 24 of the gateway's endpoints are free (no payment required).

Quick Start

Install and go — no config, no API keys, no env vars. On first run the server auto-creates a wallet, saves it to ~/.spraay/.session, and prints the address to stderr. Fund that address with USDC on Base and start calling tools.

Read Security & Wallet Safety — these tools move real funds.

One-line install (Claude Code)

bash
claude mcp add spraay -s user -- npx -y spraay-x402-mcp

Manual config (Cursor / Claude Desktop)

Cursor (.cursor/mcp.json) or Claude Desktop (claude_desktop_config.json):

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

That's it. The first run prints something like:

💧 Spraay created a new wallet: 0xABC…123   Private key saved to ~/.spraay/.session (keep it safe — it controls funds).   Fund this address with USDC on Base to start paying for tool calls.
Optional — bring your own wallet

To sign with a key you already control instead of the auto-created one, set EVM_PRIVATE_KEY in your environment (it overrides the session wallet). Never paste a raw key into a committed config file — use a dedicated hot wallet funded only with what the agent may spend. See Security & Wallet Safety.

Remote URL (no wallet on your machine)

Settlement is handled gateway-side; your client never holds a signing key.

json
{  "mcpServers": {    "spraay": {      "url": "https://spraay-x402-mcp--plagtech.run.tools"    }  }}

Smithery

bash
smithery mcp add Plagtech/Spraay-x402-mcp

From source

bash
git clone https://github.com/plagtech/spraay-x402-mcpcd spraay-x402-mcpnpm installnpm run buildnpm start                     # auto-creates a wallet on first run

Tool catalog

183 tools spanning the gateway's 33 categories. Highlights by area:

AreaWhat it covers
AI & Inference200+ LLMs (OpenAI-compatible), wallet/tx classification, contract explanation, summaries
ComputeText / image / video / TTS / STT / embeddings across Replicate, Chutes, OpenRouter; batch jobs
Compute FuturesPrepaid compute credits with tier discounts; draw down per inference
BittensorDecentralized inference, image gen, and embeddings via SN64 / SN19
PaymentsBatch payouts up to 200 recipients (Base, XRP Ledger, Stellar); estimates
PayrollStablecoin payroll runs across Base, Ethereum, Solana
Invoicing & EscrowCrypto-native invoices and milestone escrow (persistent)
DeFi & DataSwaps (Uniswap V3 / Aerodrome), oracle prices/gas/FX, bridge quotes, balances, ENS/Basename
AnalyticsWallet profiles and decoded transaction history
Research250M+ papers (OpenAlex), arXiv, Crossref, PubMed, PubChem, US Census, dictionary
Search & RAGWeb search, content extraction, question answering
CommunicationEmail, SMS, XMTP messaging, webhooks
InfrastructureMulti-chain RPC, IPFS/Arweave storage, cron scheduling, structured logs
Identity & ComplianceKYC/sanctions screening, auth sessions, audit trail, crypto tax (FIFO, IRS 8949)
Supply Chain (SCTP)Supplier registration, purchase orders, invoice verification, settlement
Robotics (RTP)Register robots, dispatch paid tasks, escrow-backed completion
Trust & SafetyProofLayer trust scores; free token-safety, address-safety, and tx-decode checks

24 free endpoints require no payment — gas/prices/chain-status, address & batch validation, ENS resolution, unit conversion, x402 discovery probes, and model/compute discovery.

For the exact, current tool list and per-tool pricing, query the live manifest:

bash
curl https://gateway.spraay.app/.well-known/x402.json

Pricing ranges from $0.001 (reads) to ~$0.10 (payroll, escrow release, tax), settled in USDC on Base.

How it works

  1. An agent calls a tool (e.g. spraay_batch_execute).
  2. The MCP server hits the Spraay x402 Gateway.
  3. The gateway responds 402 Payment Required with a USDC amount.
  4. Remote mode: settlement is handled gateway-side. Local mode: @x402/axios signs a USDC micropayment from the auto-created (or overridden) wallet.
  5. The gateway validates payment and returns the data.

Security & Wallet Safety

These tools can initiate real USDC payments. Treat the server like any tool with funds access.

  • The auto-created wallet only holds what you send it. Fund it with only as much USDC as you're willing to let the agent spend. It starts empty, so a fresh install cannot move funds until you fund it; read-only tools work regardless.
  • The session key lives at ~/.spraay/.session. Protect that file like any secret — anyone who reads it controls the wallet. It's written with 0600 permissions on POSIX systems. Back it up if the funds matter; delete it to rotate to a new wallet on the next run.
  • Prefer the remote URL if you'd rather keep no signing key on your machine — settlement is handled gateway-side.
  • If you bring your own key via EVM_PRIVATE_KEY, use a dedicated hot wallet that controls no other assets, and never put a raw private key in a config file, issue, or any committed file — keep it in your shell environment only.

The published npm package ships only dist/, README, and LICENSE (verify with npm pack --dry-run) — no binaries, no build tooling, no install scripts.

Report security issues to [email protected], not a public issue.

Requirements

  • Node.js 20+
  • MCP client — Claude Desktop, Cursor, or any MCP-compatible client
  • USDC on Base — fund the auto-created wallet (or your own); even $1 covers thousands of calls

Environment variables

None are required — the server runs with zero configuration. All of the following are optional overrides.

VariableRequiredDefaultDescription
EVM_PRIVATE_KEYNoauto-created at ~/.spraay/.sessionOverride the auto-created wallet with your own key. Use a dedicated, funded-as-needed hot wallet.
SPRAAY_GATEWAY_URLNohttps://gateway.spraay.appOverride the gateway URL.

Links

License

MIT

Source: README.md at commit 327cfc7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v3.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts