Spraay X402 MCP server

Read from the package source without running it. The installed server may list more.

• spraay_analytics_txhistory

  Get decoded transaction history for any address on Base. Returns transaction types, values, timestamps, and decoded method calls. Costs $0.003 USDC.

• spraay_analytics_wallet

  Get a comprehensive wallet profile including ETH + token balances, wallet age, entity classification, and portfolio breakdown on Base. Costs $0.005 USDC.

• spraay_audit_log

  Record an immutable audit trail entry for payments, escrows, compliance actions, and other events. Data persists in Supabase. Costs $0.001 USDC.

• spraay_audit_query

  Query the audit trail by actor, action, resource, or time range. Returns matching entries sorted newest first. Data persists in Supabase. Costs $0.005 USDC.

• spraay_auth_sessionwrite action

  Create an authenticated session with scoped permissions and configurable TTL. Returns a session token (spr_...) for use in Authorization headers. Data persists in Supabase. Costs $0.005 USDC.

• spraay_auth_verify

  Verify a session token and check its permissions, expiry, and associated address. Data persists in Supabase. Costs $0.001 USDC.

• spraay_balances

  Get ETH + ERC-20 token balances for any wallet on Base. Returns formatted balances with USD values where available. Costs $0.002 USDC.

• spraay_batch_estimate

  Estimate gas cost for a batch payment before executing. Returns estimated gas in wei and USD equivalent. Costs $0.001 USDC.

• spraay_batch_executewrite action

  Execute a batch payment to up to 200 recipients in a single Base transaction via the Spraay protocol. Supports any ERC-20 token or native ETH. Returns unsigned transaction data for the sender to sign. Costs $0.01 USDC.

• spraay_bridge_chains

  List all chains supported by the Spraay bridge aggregator (LI.FI). Returns chain names, IDs, and supported tokens. Costs $0.001 USDC.

• spraay_bridge_quote

  Get a cross-chain bridge quote via LI.FI aggregator. Supports Base, Ethereum, Arbitrum, Polygon, BNB Chain, Avalanche, Optimism, and more. Returns estimated output, fees, and execution time. Costs $0.005 USDC.

• spraay_chatwrite action

  Send a message to 200+ AI models (GPT-4o, Claude, Llama 3, Gemini, Mistral, etc.) via the Spraay x402 Gateway. Returns the model's completion. Use spraay_models to discover available model IDs. Costs $0.005 USDC.

• spraay_classify_address

  AI-powered wallet classification with risk scoring. Analyzes on-chain activity to classify addresses as whale, retail, MEV bot, exchange, bridge, or contract. Returns risk score, classification, confidence, and behavioral signals. Costs $0.008 USDC.

• spraay_classify_tx

  AI-powered transaction classification with risk scoring. Decodes, categorizes, and analyzes any Base transaction. Returns type (swap, transfer, contract call, etc.), risk level, and decoded parameters. Costs $0.008 USDC.

• spraay_cron_cancelwrite action

  Cancel a scheduled job by ID. Stops future executions. Data persists in Supabase. Costs $0.001 USDC.

• spraay_cron_createwrite action

  Create a scheduled job for recurring payments, DCA strategies, reminders, or any gateway action. Supports standard 5-part cron expressions. Data persists in Supabase. Costs $0.005 USDC.

• spraay_cron_list

  List all scheduled jobs with optional status and action filters. Data persists in Supabase. Costs $0.001 USDC.

• spraay_escrow_cancelwrite action

  Cancel an escrow. Depositor can cancel unfunded escrows; depositor or arbiter can cancel funded ones. Data persists in Supabase. Costs $0.002 USDC.

• spraay_escrow_createwrite action

  Create a conditional escrow with optional milestones, arbiter, and expiry on Base. Funds are held until release conditions are met. Data persists in Supabase. Returns escrow ID and next-step actions. Costs $0.008 USDC.

• spraay_escrow_fund

  Mark an escrow as funded. Changes status from 'created' to 'funded'. Only works on unfunded, non-expired escrows. Data persists in Supabase. Costs $0.002 USDC.

• spraay_escrow_get

  Get full escrow details including status, participants, conditions, balance check, and timestamps by ID. Data persists in Supabase. Costs $0.001 USDC.

• spraay_escrow_list

  List escrows by address (depositor, beneficiary, or arbiter) with optional status filter. Data persists in Supabase. Costs $0.002 USDC.

• spraay_escrow_release

  Release escrow funds to the beneficiary. Returns an unsigned ERC-20 transfer transaction for the depositor to sign. Only depositor or arbiter can release. Data persists in Supabase. Costs $0.005 USDC.

• spraay_explain_contract

  AI-powered smart contract analysis. Explains what a verified contract does, lists its functions, identifies patterns (ERC-20, ERC-721, etc.), and flags security properties. Costs $0.01 USDC.

• spraay_gpu_models

  List all available GPU model shortcuts grouped by category (image, video, LLM, audio, utility). Shows shortcut names, full Replicate model IDs, and descriptions. You can also use any Replicate model by its full ID. FREE — no USDC cost.

• spraay_gpu_runwrite action

  Run AI model inference on GPU via Replicate. Supports image generation (flux-pro, sdxl, ideogram), video generation (wan-video, minimax-video), LLMs (llama-70b, llama-8b, mixtral), audio (whisper transcription, musicgen), and utilities (esrgan upscaling, rembg background removal). Use shortcuts like 'flux-pro' or full model IDs like 'owner/model'. Returns output directly for fast models, or a poll

• spraay_gpu_status

  Check the status of a GPU prediction by ID. Use this to poll for results on longer-running jobs like video generation or large model inference. Returns output when complete. Costs $0.002 USDC.

• spraay_invoice_createwrite action

  Create a payment invoice with a pre-encoded ERC-20 transfer transaction. Supports USDC, USDT, DAI, EURC, WETH on Base. Data persists in Supabase. Returns invoice ID, payment instructions, and unsigned tx. Costs $0.005 USDC.

• spraay_invoice_get

  Look up a specific invoice by ID. Returns full invoice details, on-chain balance check, and payment status. Data persists in Supabase. Costs $0.001 USDC.

• spraay_invoice_list

  List invoices by creator or payer address with optional status filter. Data persists in Supabase. Costs $0.002 USDC.

• spraay_kyc_status

  Check KYC verification status by record ID or wallet address. Returns verification level, check results, and expiry. Data persists in Supabase. Costs $0.005 USDC.

• spraay_kyc_verify

  Initiate KYC/KYB verification for compliance-gated payments. Supports individual and business verification at basic, enhanced, or full levels. Data persists in Supabase. Costs $0.05 USDC.

• spraay_logs_ingest

  Ingest structured logs for debugging and monitoring agent workflows. Accepts up to 100 entries per batch. Data persists in Supabase. Costs $0.001 USDC.

• spraay_logs_query

  Query structured logs by service, level, and time range. Returns matching log entries sorted newest first. Data persists in Supabase. Costs $0.003 USDC.

• spraay_models

  List all 200+ AI models available on the Spraay x402 Gateway. Returns model IDs, providers, and context window sizes. Costs $0.001 USDC.

• spraay_notify_emailwrite action

  Send an email notification via AgentMail for payment confirmations, alerts, receipts, or general communication. Supports subject, CC, and reply-to. Costs $0.003 USDC.

• spraay_notify_smswrite action

  Send an SMS notification for payment alerts (simulated — Twilio integration coming). Requires E.164 phone format. Costs $0.005 USDC.

• spraay_notify_status

  Check delivery status of a previously sent email or SMS notification by notification ID. Costs $0.001 USDC.

• spraay_oracle_fx

  Get stablecoin exchange rates with depeg detection. Returns cross-rates between USDC, USDT, DAI, and EURC. Costs $0.002 USDC.

• spraay_oracle_gas

  Get current gas prices on Base in gwei. Returns base fee, priority fee, and estimated transaction costs. Costs $0.001 USDC.

• spraay_oracle_prices

  Get real-time on-chain token prices with confidence scores from Uniswap V3 QuoterV2 on Base. Returns USD prices for ETH, WETH, cbBTC, USDT, DAI, EURC, and more. Costs $0.003 USDC.

• spraay_payroll_estimate

  Estimate gas and fees for a payroll batch before executing. Returns estimated gas in wei and USD. Costs $0.002 USDC.

• spraay_payroll_executewrite action

  Execute a payroll batch payment via Spraay V2 contract on Base. Pay up to 200 employees in a single transaction with any stablecoin. Returns unsigned transaction data. Costs $0.02 USDC.

• spraay_payroll_tokens

  List all stablecoins supported for payroll on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.

• spraay_prices

  Get live on-chain token prices on Base from Uniswap V3 pools. Returns USD prices with timestamps. Costs $0.002 USDC.

• spraay_resolve

  Resolve ENS names (.eth) and Basenames (.base.eth) to wallet addresses, or perform reverse lookup from address to name. Costs $0.001 USDC.

• spraay_rpc_call

  Make a premium multi-chain JSON-RPC call via Alchemy (EVM) or Helius (Solana). Supports Base, Ethereum, Arbitrum, Polygon, BNB Chain, Avalanche, and Solana. Costs $0.001 USDC.

• spraay_rpc_chains

  List all chains supported by the Spraay RPC proxy and their allowed JSON-RPC methods. Costs $0.001 USDC.

• spraay_search_extract

  Extract clean, structured content from specific URLs — perfect for RAG pipelines. Returns the full text content of each page, ready for LLM consumption. Up to 5 URLs per request. Costs $0.015 USDC.

• spraay_search_qna

  Ask a question and get a direct, synthesized answer with cited sources. Searches the web, extracts relevant content, and generates a comprehensive answer. Great for research and fact-checking. Costs $0.02 USDC.

• spraay_search_web

  Search the web and get clean, LLM-ready results via Tavily. Returns extracted content (not just links), plus an AI-generated answer. Supports basic and advanced search depth, domain filtering, and topic focus (general, news, finance). Costs $0.01 USDC.

• spraay_storage_get

  Retrieve previously pinned content from IPFS/Arweave by CID. Returns the stored data. Costs $0.002 USDC.

• spraay_storage_pin

  Pin content to IPFS via Pinata for permanent decentralized storage. Returns CID (content identifier) for retrieval. Supports text, JSON, and base64 data. Costs $0.005 USDC.

• spraay_storage_status

  Check the pin status of a storage request by pin ID. Returns pinning progress and confirmation. Costs $0.001 USDC.

• spraay_summarize

  AI intelligence briefing for any wallet address or transaction hash. Returns structured risk assessment, entity classification, activity summary, and actionable insights. Costs $0.008 USDC.

• spraay_swap_executewrite action

  Execute a token swap via Uniswap V3 on Base. Returns unsigned transaction data for the caller to sign and broadcast. Get a quote first with spraay_swap_quote. Costs $0.01 USDC.

• spraay_swap_quote

  Get a swap quote from Uniswap V3 on Base. Returns expected output amount, price impact, and route details. Use spraay_swap_tokens to see available tokens. Costs $0.002 USDC.

• spraay_swap_tokens

  List all tokens available for swapping on Spraay via Uniswap V3 on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.

• spraay_tax_calculate

  Calculate crypto tax gain/loss using FIFO method for up to 500 transactions. Returns per-event breakdown and aggregate summary with short/long-term classification. Data persists in Supabase. Costs $0.01 USDC.

• spraay_tax_report

  Retrieve a previously calculated tax report by ID, or list all reports. Data persists in Supabase. Costs $0.02 USDC.

• spraay_webhook_deletewrite action

  Delete a registered webhook by ID. Removes it permanently from Supabase. Costs $0.001 USDC.

• spraay_webhook_list

  List all registered webhooks with their status, subscribed events, and delivery stats. Data persists in Supabase. Costs $0.001 USDC.

• spraay_webhook_register

  Register a webhook endpoint to receive real-time POST events for payments, escrows, swaps, invoices, and more. Returns webhook ID and HMAC secret for signature verification. Data persists in Supabase. Costs $0.003 USDC.

• spraay_webhook_testwrite action

  Send a test ping event to a registered webhook to verify delivery and signature validation. Data persists in Supabase. Costs $0.002 USDC.

• spraay_xmtp_inbox

  Read XMTP inbox messages for an Ethereum address. Returns decrypted messages from the production XMTP network. Costs $0.002 USDC.

• spraay_xmtp_sendwrite action

  Send an encrypted XMTP message to any Ethereum address on the XMTP production network. Messages are end-to-end encrypted. Costs $0.003 USDC.

• Code scan10 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 88 days ago12/15
• Maintainer identityregistry namespace matches repository owner6/10

Safety score

75/100

higher than 50% of 1,761 Finance servers

Tools

66

the typical Finance server has 8

Tools that change things

24%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

4

more than 85% of 946 Finance servers

Downloads a week

43

more than 38% of 421 Finance servers with a package

Spraay X402: common questions

Is Spraay X402 MCP server safe?

Mostly: it is graded B (75/100). Read the Spraay X402 safety report

How do I install Spraay X402?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Spraay X402 need an API key?

Yes. The registry entry asks for X402_WALLET_PRIVATE_KEY.

Is Spraay X402 maintained?

The last commit was 125 days ago (2026-07-01). The latest release is v3.1.1.

What can I use instead of Spraay X402?

Servers from other publishers that do the same job: PayRam MCP server, Blockrun MCP server and three.ws Agent Payments MCP server. Compare all Spraay X402 alternatives.

How does Spraay X402 compare with other Finance MCP servers?

safety score 75/100 (higher than 50% of 1,761 Finance servers); tools 66 (the typical Finance server has 8); tools that change things 24% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.