Spraay x402 MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EVM_PRIVATE_KEY | Yes | Private key of a wallet with USDC on Base mainnet | |
| SPRAAY_GATEWAY_URL | No | Gateway URL (default: https://gateway.spraay.app) | https://gateway.spraay.app |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| spraay_chatA | 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_modelsA | List all 200+ AI models available on the Spraay x402 Gateway. Returns model IDs, providers, and context window sizes. Costs $0.001 USDC. |
| spraay_batch_executeA | 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_batch_estimateA | Estimate gas cost for a batch payment before executing. Returns estimated gas in wei and USD equivalent. Costs $0.001 USDC. |
| spraay_swap_quoteA | 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_tokensA | List all tokens available for swapping on Spraay via Uniswap V3 on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC. |
| spraay_swap_executeA | 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_oracle_pricesA | 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_oracle_gasA | Get current gas prices on Base in gwei. Returns base fee, priority fee, and estimated transaction costs. Costs $0.001 USDC. |
| spraay_oracle_fxA | Get stablecoin exchange rates with depeg detection. Returns cross-rates between USDC, USDT, DAI, and EURC. Costs $0.002 USDC. |
| spraay_bridge_quoteA | 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_bridge_chainsA | List all chains supported by the Spraay bridge aggregator (LI.FI). Returns chain names, IDs, and supported tokens. Costs $0.001 USDC. |
| spraay_payroll_executeA | 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_estimateA | Estimate gas and fees for a payroll batch before executing. Returns estimated gas in wei and USD. Costs $0.002 USDC. |
| spraay_payroll_tokensA | List all stablecoins supported for payroll on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC. |
| spraay_invoice_createA | 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_listA | List invoices by creator or payer address with optional status filter. Data persists in Supabase. Costs $0.002 USDC. |
| spraay_invoice_getA | 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_analytics_walletA | Get a comprehensive wallet profile including ETH + token balances, wallet age, entity classification, and portfolio breakdown on Base. Costs $0.005 USDC. |
| spraay_analytics_txhistoryA | Get decoded transaction history for any address on Base. Returns transaction types, values, timestamps, and decoded method calls. Costs $0.003 USDC. |
| spraay_escrow_createA | 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_listA | List escrows by address (depositor, beneficiary, or arbiter) with optional status filter. Data persists in Supabase. Costs $0.002 USDC. |
| spraay_escrow_getA | Get full escrow details including status, participants, conditions, balance check, and timestamps by ID. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_escrow_fundA | 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_releaseA | 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_escrow_cancelA | Cancel an escrow. Depositor can cancel unfunded escrows; depositor or arbiter can cancel funded ones. Data persists in Supabase. Costs $0.002 USDC. |
| spraay_classify_addressA | 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_txA | 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_explain_contractA | 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_summarizeA | 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_notify_emailA | 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_smsA | Send an SMS notification for payment alerts (simulated — Twilio integration coming). Requires E.164 phone format. Costs $0.005 USDC. |
| spraay_notify_statusA | Check delivery status of a previously sent email or SMS notification by notification ID. Costs $0.001 USDC. |
| spraay_webhook_registerB | 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_testA | Send a test ping event to a registered webhook to verify delivery and signature validation. Data persists in Supabase. Costs $0.002 USDC. |
| spraay_webhook_listA | List all registered webhooks with their status, subscribed events, and delivery stats. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_webhook_deleteA | Delete a registered webhook by ID. Removes it permanently from Supabase. Costs $0.001 USDC. |
| spraay_xmtp_sendA | Send an encrypted XMTP message to any Ethereum address on the XMTP production network. Messages are end-to-end encrypted. Costs $0.003 USDC. |
| spraay_xmtp_inboxA | Read XMTP inbox messages for an Ethereum address. Returns decrypted messages from the production XMTP network. Costs $0.002 USDC. |
| spraay_rpc_callA | 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_chainsA | List all chains supported by the Spraay RPC proxy and their allowed JSON-RPC methods. Costs $0.001 USDC. |
| spraay_storage_pinA | 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_getA | Retrieve previously pinned content from IPFS/Arweave by CID. Returns the stored data. Costs $0.002 USDC. |
| spraay_storage_statusA | Check the pin status of a storage request by pin ID. Returns pinning progress and confirmation. Costs $0.001 USDC. |
| spraay_cron_createA | 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_listA | List all scheduled jobs with optional status and action filters. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_cron_cancelA | Cancel a scheduled job by ID. Stops future executions. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_logs_ingestA | 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_queryA | 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_kyc_verifyA | 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_kyc_statusA | 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_auth_sessionA | 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_verifyA | Verify a session token and check its permissions, expiry, and associated address. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_audit_logA | Record an immutable audit trail entry for payments, escrows, compliance actions, and other events. Data persists in Supabase. Costs $0.001 USDC. |
| spraay_audit_queryB | 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_tax_calculateA | 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_reportA | Retrieve a previously calculated tax report by ID, or list all reports. Data persists in Supabase. Costs $0.02 USDC. |
| spraay_gpu_runA | 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 URL for longer jobs. Costs $0.05 USDC. |
| spraay_gpu_statusA | 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_gpu_modelsA | 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_search_webA | 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_search_extractA | 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_qnaA | 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_pricesA | Get live on-chain token prices on Base from Uniswap V3 pools. Returns USD prices with timestamps. Costs $0.002 USDC. |
| spraay_balancesA | Get ETH + ERC-20 token balances for any wallet on Base. Returns formatted balances with USD values where available. Costs $0.002 USDC. |
| spraay_resolveA | Resolve ENS names (.eth) and Basenames (.base.eth) to wallet addresses, or perform reverse lookup from address to name. Costs $0.001 USDC. |
| spraay_tokensC | Tokens. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_robots_registerB | Register Robot (RTP). Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_robots_completeA | Report Task Complete (RTP). Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_robots_updateB | Update Robot (RTP). Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_robots_deregisterC | Remove Robot (RTP). Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_bittensor_healthC | Bittensor health. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_freeC | Free tier catalog. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_gasA | Gas prices — 7 EVM chains via Alchemy (cached 15s). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_pricesB | USDC/ETH/SOL spot prices (cached 60s). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_chain_statusA | Block height & liveness — 7 EVM chains (cached 30s). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_nonceA | EVM nonce / tx count for address. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_validate_addressA | Multi-chain address checksum validation. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_validate_batchA | BPA 1.0 payload schema validation. Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_free_estimate_batchA | Rough batch cost estimate (no live quote). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_resolveA | ENS & Basename → address resolution. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_agent_cardA | ERC-8004 agent registry lookup. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_x402_checkC | Probe URL for x402 payment support. Free to call. Pass the request payload as a JSON string via the body argument. |
| spraay_free_convertA | Fiat ↔ crypto conversion (unit math + spot). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_timestampB | Current Unix timestamp. Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_free_uuidA | UUID v4 generator (up to 100). Free to call. Read-only. Pass any query parameters as a JSON string via the params argument. |
| spraay_robots_taskA | Dispatch robot task (RTP). Costs $0.05 USDC per call. Provide the listed fields as typed arguments. |
| spraay_robots_listB | Discover robots. Costs $0.005 USDC per call. Read-only. Pass the listed fields directly as typed arguments. |
| spraay_robots_statusA | Poll task status. Costs $0.002 USDC per call. Read-only. Pass the listed fields directly as typed arguments. |
| spraay_robots_profileB | Robot profile. Costs $0.002 USDC per call. Read-only. Pass the listed fields directly as typed arguments. |
| spraay_agent_wallet_provisionB | Provision agent wallet. Costs $0.05 USDC per call. Provide the listed fields as typed arguments. |
| spraay_agent_wallet_session_keyB | Add session key. Costs $0.02 USDC per call. Provide the listed fields as typed arguments. |
| spraay_agent_wallet_infoC | Agent wallet info. Costs $0.005 USDC per call. Read-only. Pass the listed fields directly as typed arguments. |
| spraay_agent_wallet_revoke_keyC | Revoke session key. Costs $0.02 USDC per call. Provide the listed fields as typed arguments. |
| spraay_agent_wallet_predictA | Predict wallet address. Costs $0.001 USDC per call. Read-only. Pass the listed fields directly as typed arguments. |
| spraay_sctp_supplierB | Register supplier. Costs $0.02 USDC per call. Provide the listed fields as typed arguments. |
| spraay_sctp_supplier_by_idA | Get supplier. Costs $0.005 USDC per call. Read-only. Provide the path parameter to fetch a single record. |
| spraay_sctp_poB | Create purchase order. Costs $0.02 USDC per call. Provide the listed fields as typed arguments. |
| spraay_sctp_po_by_idA | Get purchase order. Costs $0.005 USDC per call. Read-only. Provide the path parameter to fetch a single record. |
| spraay_sctp_invoiceB | Submit invoice. Costs $0.02 USDC per call. Provide the listed fields as typed arguments. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze-wallet | Comprehensive wallet analysis: classification, balances, risk scoring, and transaction history |
| create-escrow | Step-by-step escrow creation with milestones between depositor and beneficiary |
| batch-payroll | Execute payroll with gas estimation and audit logging |
| defi-swap | Get a quote and execute a token swap on Base via Uniswap V3 |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| gateway-info | Spraay x402 Gateway metadata — version, endpoints, supported chains, and pricing overview |
| supported-tokens | All tokens supported by Spraay for payments, swaps, and escrow on Base |
| supported-chains | All 11 chains supported by Spraay batch payments protocol |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/plagtech/spraay-x402-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server