Summary
This connects Claude to a pay-per-use DeFi gateway with 57 tools spanning crypto payments, swaps, bridging, payroll, escrow, and AI inference. You get batch USDC payments, Uniswap V3 swaps, cross-chain bridging, invoice generation with Supabase persistence, wallet analytics, XMTP messaging, IPFS pinning, and access to 200+ AI models. Operations cost $0.001 to $0.05 in USDC on Base, paid automatically via the x402 protocol. Your agent needs an EVM private key with a few dollars of USDC. Reach for this when you want your AI to execute onchain financial operations or coordinate DeFi workflows without managing API keys or service accounts.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
spraay_chatSend 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.3 params
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.
Parameters* required
modelstringModel ID in OpenRouter format (e.g. 'openai/gpt-4o-mini', 'anthropic/claude-3.5-sonnet', 'meta-llama/llama-3-70b-instruct'). Use spraay_models to list all.default: openai/gpt-4o-mini
messagestringUser message to send to the model
systemPromptstringOptional system prompt to set model behavior and context
spraay_modelsList all 200+ AI models available on the Spraay x402 Gateway. Returns model IDs, providers, and context window sizes. Costs $0.001 USDC.
List all 200+ AI models available on the Spraay x402 Gateway. Returns model IDs, providers, and context window sizes. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_batch_executeExecute 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.4 params
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.
Parameters* required
tokenstringToken symbol (e.g. 'USDC', 'ETH', 'WETH', 'DAI') or ERC-20 contract address on Base
senderstringSender wallet address that will sign the transaction
amountsarrayArray of amounts in token units (e.g. '100' for 100 USDC). Must match recipients length.
recipientsarrayArray of 1-200 recipient wallet addresses
spraay_batch_estimateEstimate gas cost for a batch payment before executing. Returns estimated gas in wei and USD equivalent. Costs $0.001 USDC.2 params
Estimate gas cost for a batch payment before executing. Returns estimated gas in wei and USD equivalent. Costs $0.001 USDC.
Parameters* required
tokenstringToken symbol (default: USDC)
recipientCountnumberNumber of recipients (1-200)
spraay_swap_quoteGet 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.3 params
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.
Parameters* required
tokenInstringInput token symbol (e.g. 'USDC', 'WETH', 'DAI') or contract address
amountInstringAmount to swap in human-readable units (e.g. '1000' for 1000 USDC)
tokenOutstringOutput token symbol (e.g. 'WETH', 'USDC') or contract address
spraay_swap_tokensList all tokens available for swapping on Spraay via Uniswap V3 on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.
List all tokens available for swapping on Spraay via Uniswap V3 on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_swap_executeExecute 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.5 params
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.
Parameters* required
tokenInstringInput token symbol (e.g. 'USDC') or contract address
amountInstringAmount to swap in human-readable units
slippagenumberSlippage tolerance in percent (default: 0.5, max: 50)
tokenOutstringOutput token symbol (e.g. 'WETH') or contract address
recipientstringRecipient address for swap output (e.g. '0xYourWallet')
spraay_oracle_pricesGet 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.1 params
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.
Parameters* required
tokensstringComma-separated token symbols (e.g. 'ETH,cbBTC,USDT'). Omit to get all supported token prices.
spraay_oracle_gasGet current gas prices on Base in gwei. Returns base fee, priority fee, and estimated transaction costs. Costs $0.001 USDC.
Get current gas prices on Base in gwei. Returns base fee, priority fee, and estimated transaction costs. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_oracle_fxGet stablecoin exchange rates with depeg detection. Returns cross-rates between USDC, USDT, DAI, and EURC. Costs $0.002 USDC.1 params
Get stablecoin exchange rates with depeg detection. Returns cross-rates between USDC, USDT, DAI, and EURC. Costs $0.002 USDC.
Parameters* required
basestringBase stablecoin for rate calculation (default: 'USDC'). Options: USDC, USDT, DAI, EURC
spraay_bridge_quoteGet 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.5 params
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.
Parameters* required
tokenstringToken symbol to bridge (e.g. 'USDC', 'ETH')
amountstringAmount in smallest units (e.g. '1000000' for 1 USDC with 6 decimals)
toChainstringDestination chain name (e.g. 'ethereum', 'arbitrum', 'polygon')
fromChainstringSource chain name (e.g. 'base', 'ethereum', 'arbitrum', 'polygon')
fromAddressstringSender wallet address on source chain
spraay_bridge_chainsList all chains supported by the Spraay bridge aggregator (LI.FI). Returns chain names, IDs, and supported tokens. Costs $0.001 USDC.
List all chains supported by the Spraay bridge aggregator (LI.FI). Returns chain names, IDs, and supported tokens. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_payroll_executeExecute 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.3 params
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.
Parameters* required
tokenstringPayment token symbol (e.g. 'USDC', 'USDT', 'DAI')
senderstringEmployer/sender wallet address
employeesarrayArray of 1-200 employee payment objects
spraay_payroll_estimateEstimate gas and fees for a payroll batch before executing. Returns estimated gas in wei and USD. Costs $0.002 USDC.2 params
Estimate gas and fees for a payroll batch before executing. Returns estimated gas in wei and USD. Costs $0.002 USDC.
Parameters* required
tokenstringPayment token symbol (default: 'USDC')
employeeCountnumberNumber of employees to pay (1-200)
spraay_payroll_tokensList all stablecoins supported for payroll on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.
List all stablecoins supported for payroll on Base. Returns symbols, addresses, and decimals. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_invoice_createCreate 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.6 params
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.
Parameters* required
memostringInvoice description/memo (e.g. 'Web development - March 2026')
tokenstringPayment token symbol (e.g. 'USDC', 'USDT', 'DAI', 'EURC', 'WETH')
amountstringInvoice amount in human-readable units (e.g. '1500.00' for $1500)
creatorstringInvoice creator/payee wallet address (e.g. '0xYourAddress')
dueDatestringPayment deadline in ISO 8601 format (e.g. '2026-04-15')
recipientstringPayer address — omit for open invoice (anyone can pay)
spraay_invoice_listList invoices by creator or payer address with optional status filter. Data persists in Supabase. Costs $0.002 USDC.2 params
List invoices by creator or payer address with optional status filter. Data persists in Supabase. Costs $0.002 USDC.
Parameters* required
statusstringFilter by invoice statusone of
pending · paid · expired · cancelledaddressstringCreator or payer address to filter by (e.g. '0xYourAddress')
spraay_invoice_getLook 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.1 params
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.
Parameters* required
idstringInvoice ID (e.g. 'INV-A1B2C3D4E5F6')
spraay_analytics_walletGet a comprehensive wallet profile including ETH + token balances, wallet age, entity classification, and portfolio breakdown on Base. Costs $0.005 USDC.1 params
Get a comprehensive wallet profile including ETH + token balances, wallet age, entity classification, and portfolio breakdown on Base. Costs $0.005 USDC.
Parameters* required
addressstringWallet address to analyze (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
spraay_analytics_txhistoryGet decoded transaction history for any address on Base. Returns transaction types, values, timestamps, and decoded method calls. Costs $0.003 USDC.2 params
Get decoded transaction history for any address on Base. Returns transaction types, values, timestamps, and decoded method calls. Costs $0.003 USDC.
Parameters* required
limitstringMax transactions to return (default: '10', max: '100')
addressstringWallet address to get history for
spraay_escrow_createCreate 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.7 params
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.
Parameters* required
tokenstringToken symbol (e.g. 'USDC', 'USDT', 'DAI', 'EURC', 'WETH')
amountstringEscrow amount in human-readable units (e.g. '5000.00')
arbiterstringOptional third-party arbiter who can release or cancel
depositorstringDepositor/client address who will fund the escrow
expiresInnumberExpiry in hours (1-8760, default: 168 = 7 days)
conditionsarrayMilestone conditions (e.g. ['Design approved', 'Dev complete'])
beneficiarystringBeneficiary/freelancer address who receives funds on release
spraay_escrow_listList escrows by address (depositor, beneficiary, or arbiter) with optional status filter. Data persists in Supabase. Costs $0.002 USDC.2 params
List escrows by address (depositor, beneficiary, or arbiter) with optional status filter. Data persists in Supabase. Costs $0.002 USDC.
Parameters* required
statusstringFilter by escrow statusone of
created · funded · released · cancelled · expiredaddressstringAddress to list escrows for (depositor, beneficiary, or arbiter)
spraay_escrow_getGet full escrow details including status, participants, conditions, balance check, and timestamps by ID. Data persists in Supabase. Costs $0.001 USDC.1 params
Get full escrow details including status, participants, conditions, balance check, and timestamps by ID. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
idstringEscrow ID (e.g. 'ESC-A1B2C3D4E5F6')
spraay_escrow_fundMark 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.1 params
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.
Parameters* required
escrowIdstringEscrow ID to fund (e.g. 'ESC-A1B2C3D4E5F6')
spraay_escrow_releaseRelease 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.2 params
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.
Parameters* required
callerstringCaller address — must be depositor or arbiter
escrowIdstringEscrow ID to release (e.g. 'ESC-A1B2C3D4E5F6')
spraay_escrow_cancelCancel an escrow. Depositor can cancel unfunded escrows; depositor or arbiter can cancel funded ones. Data persists in Supabase. Costs $0.002 USDC.2 params
Cancel an escrow. Depositor can cancel unfunded escrows; depositor or arbiter can cancel funded ones. Data persists in Supabase. Costs $0.002 USDC.
Parameters* required
callerstringCaller address — must be depositor (or arbiter for funded escrows)
escrowIdstringEscrow ID to cancel (e.g. 'ESC-A1B2C3D4E5F6')
spraay_classify_addressAI-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.1 params
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.
Parameters* required
addressstringEthereum/Base address to classify (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
spraay_classify_txAI-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.1 params
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.
Parameters* required
hashstringTransaction hash to classify (e.g. '0xabc123...')
spraay_explain_contractAI-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.1 params
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.
Parameters* required
addressstringContract address to analyze on Base (e.g. '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' for USDC)
spraay_summarizeAI intelligence briefing for any wallet address or transaction hash. Returns structured risk assessment, entity classification, activity summary, and actionable insights. Costs $0.008 USDC.2 params
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.
Parameters* required
targetstringAddress (0x..., 40 hex chars) or transaction hash (0x..., 64 hex chars) to summarize
contextstringContext hint to improve analysis (e.g. 'defi', 'nft', 'governance', 'bridge', 'mev')
spraay_notify_emailSend an email notification via AgentMail for payment confirmations, alerts, receipts, or general communication. Supports subject, CC, and reply-to. Costs $0.003 USDC.5 params
Send an email notification via AgentMail for payment confirmations, alerts, receipts, or general communication. Supports subject, CC, and reply-to. Costs $0.003 USDC.
Parameters* required
ccstringCC email address
tostringRecipient email address (e.g. 'user@example.com')
bodystringEmail body content (plain text or HTML)
replyTostringReply-to email address
subjectstringEmail subject line
spraay_notify_smsSend an SMS notification for payment alerts (simulated — Twilio integration coming). Requires E.164 phone format. Costs $0.005 USDC.2 params
Send an SMS notification for payment alerts (simulated — Twilio integration coming). Requires E.164 phone format. Costs $0.005 USDC.
Parameters* required
tostringPhone number in E.164 format (e.g. '+14155551234')
bodystringSMS message body (max 1600 characters)
spraay_notify_statusCheck delivery status of a previously sent email or SMS notification by notification ID. Costs $0.001 USDC.1 params
Check delivery status of a previously sent email or SMS notification by notification ID. Costs $0.001 USDC.
Parameters* required
idstringNotification ID returned from spraay_notify_email or spraay_notify_sms (e.g. 'ntf_abc123')
spraay_webhook_registerRegister 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.2 params
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.
Parameters* required
urlstringWebhook URL to receive POST events (e.g. 'https://yourapp.com/webhook')
eventsarrayEvents to subscribe to (e.g. ['payment.sent', 'escrow.funded', 'swap.completed'])
spraay_webhook_testSend a test ping event to a registered webhook to verify delivery and signature validation. Data persists in Supabase. Costs $0.002 USDC.1 params
Send a test ping event to a registered webhook to verify delivery and signature validation. Data persists in Supabase. Costs $0.002 USDC.
Parameters* required
webhookIdstringWebhook ID to test (e.g. 'whk_abc123')
spraay_webhook_listList all registered webhooks with their status, subscribed events, and delivery stats. Data persists in Supabase. Costs $0.001 USDC.1 params
List all registered webhooks with their status, subscribed events, and delivery stats. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
statusstringFilter by webhook statusone of
active · paused · failedspraay_webhook_deleteDelete a registered webhook by ID. Removes it permanently from Supabase. Costs $0.001 USDC.1 params
Delete a registered webhook by ID. Removes it permanently from Supabase. Costs $0.001 USDC.
Parameters* required
webhookIdstringWebhook ID to delete (e.g. 'whk_abc123')
spraay_xmtp_sendSend an encrypted XMTP message to any Ethereum address on the XMTP production network. Messages are end-to-end encrypted. Costs $0.003 USDC.3 params
Send an encrypted XMTP message to any Ethereum address on the XMTP production network. Messages are end-to-end encrypted. Costs $0.003 USDC.
Parameters* required
tostringRecipient Ethereum address (must have XMTP enabled)
contentstringMessage content to send
contentTypestringContent type (default: 'text/plain')
spraay_xmtp_inboxRead XMTP inbox messages for an Ethereum address. Returns decrypted messages from the production XMTP network. Costs $0.002 USDC.2 params
Read XMTP inbox messages for an Ethereum address. Returns decrypted messages from the production XMTP network. Costs $0.002 USDC.
Parameters* required
limitstringMax messages to return (default: '20', max: '100')
addressstringEthereum address to check inbox for
spraay_rpc_callMake 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.3 params
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.
Parameters* required
chainstringChain identifier (e.g. 'base', 'ethereum', 'arbitrum', 'polygon', 'bnb', 'avalanche', 'solana')
methodstringJSON-RPC method (e.g. 'eth_getBalance', 'eth_blockNumber', 'eth_call', 'eth_getTransactionReceipt')
paramsarrayRPC method parameters as array (e.g. ['0xAddress', 'latest'])
spraay_rpc_chainsList all chains supported by the Spraay RPC proxy and their allowed JSON-RPC methods. Costs $0.001 USDC.
List all chains supported by the Spraay RPC proxy and their allowed JSON-RPC methods. Costs $0.001 USDC.
No parameter schema in public metadata yet.
spraay_storage_pinPin 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.3 params
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.
Parameters* required
datastringContent to pin — JSON string, plain text, or base64-encoded binary
providerstringStorage provider (default: 'ipfs')one of
ipfs · arweavecontentTypestringMIME type (default: 'application/octet-stream', e.g. 'application/json', 'text/plain')
spraay_storage_getRetrieve previously pinned content from IPFS/Arweave by CID. Returns the stored data. Costs $0.002 USDC.1 params
Retrieve previously pinned content from IPFS/Arweave by CID. Returns the stored data. Costs $0.002 USDC.
Parameters* required
cidstringContent identifier (CID) to retrieve (e.g. 'QmXoypizj...' or 'bafybeig...')
spraay_storage_statusCheck the pin status of a storage request by pin ID. Returns pinning progress and confirmation. Costs $0.001 USDC.1 params
Check the pin status of a storage request by pin ID. Returns pinning progress and confirmation. Costs $0.001 USDC.
Parameters* required
idstringPin request ID (e.g. 'pin_abc123')
spraay_cron_createCreate 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.4 params
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.
Parameters* required
actionstringGateway action to schedule (e.g. 'batch.execute', 'swap.execute', 'notify.email', 'payroll.execute', 'xmtp.send')
maxRunsnumberMax executions before auto-cancel (omit for unlimited)
payloadobjectPayload for the scheduled action (same format as the action's direct API call)
schedulestringCron expression (e.g. '0 9 * * 1' for every Monday at 9am)
spraay_cron_listList all scheduled jobs with optional status and action filters. Data persists in Supabase. Costs $0.001 USDC.2 params
List all scheduled jobs with optional status and action filters. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
actionstringFilter by action type (e.g. 'batch.execute')
statusstringFilter by job statusone of
active · paused · cancelled · completedspraay_cron_cancelCancel a scheduled job by ID. Stops future executions. Data persists in Supabase. Costs $0.001 USDC.1 params
Cancel a scheduled job by ID. Stops future executions. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
jobIdstringCron job ID to cancel (e.g. 'cron_abc123')
spraay_logs_ingestIngest structured logs for debugging and monitoring agent workflows. Accepts up to 100 entries per batch. Data persists in Supabase. Costs $0.001 USDC.1 params
Ingest structured logs for debugging and monitoring agent workflows. Accepts up to 100 entries per batch. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
entriesarrayArray of 1-100 log entries
spraay_logs_queryQuery structured logs by service, level, and time range. Returns matching log entries sorted newest first. Data persists in Supabase. Costs $0.003 USDC.4 params
Query structured logs by service, level, and time range. Returns matching log entries sorted newest first. Data persists in Supabase. Costs $0.003 USDC.
Parameters* required
levelstringFilter by log levelone of
debug · info · warn · errorlimitstringMax results to return (default: '50', max: '500')
sincestringStart time in ISO 8601 format (e.g. '2026-03-01T00:00:00Z')
servicestringFilter by service name (e.g. 'batch-agent')
spraay_kyc_verifyInitiate 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.3 params
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.
Parameters* required
typestringVerification type (default: 'individual')one of
individual · businesslevelstringVerification level (default: 'basic')one of
basic · enhanced · fulladdressstringEthereum address to verify
spraay_kyc_statusCheck KYC verification status by record ID or wallet address. Returns verification level, check results, and expiry. Data persists in Supabase. Costs $0.005 USDC.2 params
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.
Parameters* required
idstringKYC record ID (e.g. 'kyc_abc123')
addressstringEthereum address for lookup (alternative to ID)
spraay_auth_sessionCreate 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.3 params
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.
Parameters* required
addressstringEthereum address to create session for
ttlSecondsnumberSession TTL in seconds (60-86400, default: 3600 = 1 hour)
permissionsarrayScoped permissions array (e.g. ['batch:execute', 'swap:execute']). Omit or pass ['*'] for all permissions.
spraay_auth_verifyVerify a session token and check its permissions, expiry, and associated address. Data persists in Supabase. Costs $0.001 USDC.1 params
Verify a session token and check its permissions, expiry, and associated address. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
tokenstringSession token to verify (e.g. 'spr_abc123...')
spraay_audit_logRecord an immutable audit trail entry for payments, escrows, compliance actions, and other events. Data persists in Supabase. Costs $0.001 USDC.5 params
Record an immutable audit trail entry for payments, escrows, compliance actions, and other events. Data persists in Supabase. Costs $0.001 USDC.
Parameters* required
actorstringActor wallet address who performed the action
actionstringAction type (e.g. 'payment.sent', 'escrow.created', 'kyc.completed', 'auth.session_created')
txHashstringRelated on-chain transaction hash
detailsobjectAdditional details as key-value pairs
resourcestringResource identifier (e.g. 'batch_123', 'ESC-A1B2', 'INV-C3D4')
spraay_audit_queryQuery the audit trail by actor, action, resource, or time range. Returns matching entries sorted newest first. Data persists in Supabase. Costs $0.005 USDC.6 params
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.
Parameters* required
actorstringFilter by actor wallet address
limitstringMax results (default: '50', max: '500')
sincestringStart time in ISO 8601 (e.g. '2026-03-01T00:00:00Z')
untilstringEnd time in ISO 8601
actionstringFilter by action type (e.g. 'payment.sent')
resourcestringFilter by resource identifier (partial match)
spraay_tax_calculateCalculate 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.1 params
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.
Parameters* required
transactionsarrayArray of 1-500 transaction objects for tax calculation
spraay_tax_reportRetrieve a previously calculated tax report by ID, or list all reports. Data persists in Supabase. Costs $0.02 USDC.1 params
Retrieve a previously calculated tax report by ID, or list all reports. Data persists in Supabase. Costs $0.02 USDC.
Parameters* required
reportIdstringTax report ID from spraay_tax_calculate (e.g. 'tax_abc123'). Omit to list all reports.
spraay_gpu_runRun 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 remov...4 params
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 remov...
Parameters* required
inputobjectModel-specific input parameters. Image models: { prompt: '...' }. LLMs: { prompt: '...' }. Whisper: { audio: 'https://...' }. ESRGAN: { image: 'https://...' }.
modelstringModel shortcut (flux-pro, sdxl, llama-70b, whisper, esrgan, etc.) or full Replicate model ID (owner/model-name). Use spraay_gpu_models to list all shortcuts.
versionstringSpecific model version hash (optional — not needed for official models)
webhookstringWebhook URL for async result delivery (optional)
spraay_gpu_statusCheck 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.1 params
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.
Parameters* required
idstringPrediction ID returned from spraay_gpu_run
spraay_gpu_modelsList 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.
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.
No parameter schema in public metadata yet.
spraay_search_webSearch 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.6 params
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.
Parameters* required
querystringSearch query (e.g. 'latest Base ecosystem developments', 'x402 protocol explained')
topicstringTopic focus: 'general' (default), 'news' (recent events), 'finance' (markets/crypto)one of
general · news · financemax_resultsnumberNumber of results to return (default: 5, max: 20)
search_depthstringSearch depth: 'basic' (fast, default) or 'advanced' (deeper extraction, better results)one of
basic · advancedexclude_domainsarrayExclude results from these domains
include_domainsarrayOnly include results from these domains (e.g. ['docs.base.org', 'ethereum.org'])
spraay_search_extractExtract 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.1 params
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.
Parameters* required
urlsarrayArray of 1-5 URLs to extract content from (e.g. ['https://docs.base.org/overview'])
spraay_search_qnaAsk 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.2 params
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.
Parameters* required
querystringNatural language question (e.g. 'What is x402 protocol and how does it work?')
topicstringTopic focus: 'general' (default), 'news', 'finance'one of
general · news · financespraay_pricesGet live on-chain token prices on Base from Uniswap V3 pools. Returns USD prices with timestamps. Costs $0.002 USDC.1 params
Get live on-chain token prices on Base from Uniswap V3 pools. Returns USD prices with timestamps. Costs $0.002 USDC.
Parameters* required
tokenstringSpecific token symbol (e.g. 'WETH', 'cbBTC'). Omit to get all supported token prices.
spraay_balancesGet ETH + ERC-20 token balances for any wallet on Base. Returns formatted balances with USD values where available. Costs $0.002 USDC.3 params
Get ETH + ERC-20 token balances for any wallet on Base. Returns formatted balances with USD values where available. Costs $0.002 USDC.
Parameters* required
tokensstringComma-separated custom ERC-20 contract addresses to include
addressstringWallet address to check (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
showAllstringSet to 'true' to include zero balancesone of
true · falsespraay_resolveResolve ENS names (.eth) and Basenames (.base.eth) to wallet addresses, or perform reverse lookup from address to name. Costs $0.001 USDC.1 params
Resolve ENS names (.eth) and Basenames (.base.eth) to wallet addresses, or perform reverse lookup from address to name. Costs $0.001 USDC.
Parameters* required
namestringENS name (e.g. 'vitalik.eth'), Basename (e.g. 'satoshi.base.eth'), or address for reverse lookup (e.g. '0xd8dA...')
spraay_tokensTokens | [Discovery] | FREE1 params
Tokens | [Discovery] | FREE
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_robots_registerRegister Robot (RTP) | [RTP (Robotics)] | FREE1 params
Register Robot (RTP) | [RTP (Robotics)] | FREE
Parameters* required
bodystringJSON request body
spraay_robots_completeReport Task Complete (RTP) | [RTP (Robotics)] | FREE1 params
Report Task Complete (RTP) | [RTP (Robotics)] | FREE
Parameters* required
bodystringJSON request body
spraay_robots_updateUpdate Robot (RTP) | [RTP (Robotics)] | FREE1 params
Update Robot (RTP) | [RTP (Robotics)] | FREE
Parameters* required
bodystringJSON request body
spraay_robots_deregisterRemove Robot (RTP) | [RTP (Robotics)] | FREE1 params
Remove Robot (RTP) | [RTP (Robotics)] | FREE
Parameters* required
bodystringJSON request body
spraay_bittensor_healthBittensor health | [Bittensor] | FREE1 params
Bittensor health | [Bittensor] | FREE
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_robots_taskDispatch robot task (RTP) | [RTP (Robotics)] | $0.05 USDC1 params
Dispatch robot task (RTP) | [RTP (Robotics)] | $0.05 USDC
Parameters* required
bodystringJSON request body
spraay_robots_listDiscover robots | [RTP (Robotics)] | $0.005 USDC1 params
Discover robots | [RTP (Robotics)] | $0.005 USDC
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_robots_statusPoll task status | [RTP (Robotics)] | $0.002 USDC1 params
Poll task status | [RTP (Robotics)] | $0.002 USDC
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_robots_profileRobot profile | [RTP (Robotics)] | $0.002 USDC1 params
Robot profile | [RTP (Robotics)] | $0.002 USDC
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_agent_wallet_provisionProvision agent wallet | [Agent Wallets] | $0.05 USDC1 params
Provision agent wallet | [Agent Wallets] | $0.05 USDC
Parameters* required
bodystringJSON request body
spraay_agent_wallet_session_keyAdd session key | [Agent Wallets] | $0.02 USDC1 params
Add session key | [Agent Wallets] | $0.02 USDC
Parameters* required
bodystringJSON request body
spraay_agent_wallet_infoAgent wallet info | [Agent Wallets] | $0.005 USDC1 params
Agent wallet info | [Agent Wallets] | $0.005 USDC
Parameters* required
paramsstringQuery parameters as JSON (e.g. {"key":"value"})
spraay_agent_wallet_revoke_keyRevoke session key | [Agent Wallets] | $0.02 USDC1 params
Revoke session key | [Agent Wallets] | $0.02 USDC
Parameters* required
bodystringJSON request body
💧 Spraay x402 MCP Server
Full-stack DeFi infrastructure for AI agents — 148 pay-per-call tools, backed by the 153-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
Two ways to connect, depending on how payments are authorized. Read Security & Wallet Safety before the local path — these tools can move real funds.
Option 1 — Remote URL (recommended, no private key on your machine)
Settlement is handled gateway-side; your client never holds a signing key.
Cursor (.cursor/mcp.json) or Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"spraay": {
"url": "https://spraay-x402-mcp--plagtech.run.tools"
}
}
}
Option 2 — Local, self-signed (advanced)
Run the server locally and let it sign USDC payments from a wallet you control. Use the scoped, version-pinned package.
{
"mcpServers": {
"spraay": {
"command": "npx",
"args": ["-y", "@plagtech/spraay-x402-mcp@4.0.0"],
"env": {
"EVM_PRIVATE_KEY": "${EVM_PRIVATE_KEY}",
"SPRAAY_ENABLE_PAYMENTS": "true"
// Optional autonomy leash — add these ONLY when running an
// unsupervised agent. Leave them out for interactive/human use
// (no limit). See Security & Wallet Safety below.
// "SPRAAY_MAX_SPEND_USDC": "1.00",
// "SPRAAY_DAILY_CAP_USDC": "10.00"
}
}
}
}
Set EVM_PRIVATE_KEY in your shell environment — never paste a raw key into
this file. Use a dedicated hot wallet funded only with what the agent may
spend. See Security & Wallet Safety.
Smithery
smithery mcp add Plagtech/Spraay-x402-mcp
From source
git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
cp .env.example .env # then edit .env with your key (it is gitignored)
npm run build
npm start
Tool catalog
148 tools spanning the gateway's 27 categories. Highlights by area:
| Area | What it covers |
|---|---|
| AI & Inference | 200+ LLMs (OpenAI-compatible), wallet/tx classification, contract explanation, summaries |
| Compute | Text / image / video / TTS / STT / embeddings across Replicate, Chutes, OpenRouter; batch jobs |
| Compute Futures | Prepaid compute credits with tier discounts; draw down per inference |
| Bittensor | Decentralized inference, image gen, and embeddings via SN64 / SN19 |
| Payments | Batch payouts up to 200 recipients (Base, XRP Ledger, Stellar); estimates |
| Payroll | Stablecoin payroll runs across Base, Ethereum, Solana |
| Invoicing & Escrow | Crypto-native invoices and milestone escrow (persistent) |
| DeFi & Data | Swaps (Uniswap V3 / Aerodrome), oracle prices/gas/FX, bridge quotes, balances, ENS/Basename |
| Analytics | Wallet profiles and decoded transaction history |
| Research | 250M+ papers (OpenAlex), arXiv, Crossref, PubMed, PubChem, US Census, dictionary |
| Search & RAG | Web search, content extraction, question answering |
| Communication | Email, SMS, XMTP messaging, webhooks |
| Infrastructure | Multi-chain RPC, IPFS/Arweave storage, cron scheduling, structured logs |
| Identity & Compliance | KYC/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 & Safety | ProofLayer 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:
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
- An agent calls a tool (e.g.
spraay_batch_execute). - The MCP server hits the Spraay x402 Gateway.
- The gateway responds
402 Payment Requiredwith a USDC amount. - Remote mode: settlement is handled gateway-side.
Local mode:
@x402/axiossigns a USDC micropayment from your wallet, subject to the spend caps you set. - 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.
- Prefer Option 1 (remote URL) — no signing key on your machine.
- If you self-sign (Option 2): use a dedicated hot wallet, funded only with what you'll let the agent spend. Never a key that controls other assets.
- Payments are off by default.
SPRAAY_ENABLE_PAYMENTSmust betruebefore any fund-moving tool will run. A fresh install cannot spend until you opt in. Read-only tools work regardless. - Spend caps are optional — an autonomy leash for unattended agents. When you
run an agent with no human watching, set
SPRAAY_MAX_SPEND_USDC(per call) andSPRAAY_DAILY_CAP_USDCto bound the blast radius if it loops or is manipulated by upstream prompt injection. Leave them unset for interactive use — a human at the keyboard is the supervision, and there's no limit unless you add one. - Never put a raw private key in a config file, issue, or any committed file.
Keys live in a gitignored
.envor 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 security@spraay.app, not a public issue.
Requirements
- Node.js 20+
- MCP client — Claude Desktop, Cursor, or any MCP-compatible client
- Wallet (local mode only) — an EVM key with USDC on Base; even $1 covers thousands of calls
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
EVM_PRIVATE_KEY | Local mode only | — | Wallet key for USDC signing. Use a dedicated, capped hot wallet. |
SPRAAY_ENABLE_PAYMENTS | No | false | Master gate. Must be true to allow any fund-moving tool. Off = read-only. |
SPRAAY_MAX_SPEND_USDC | No | unset = no limit | Optional per-call ceiling. Set only for unattended agents. |
SPRAAY_DAILY_CAP_USDC | No | unset = no limit | Optional rolling 24h ceiling. Set only for unattended agents. |
SPRAAY_GATEWAY_URL | No | https://gateway.spraay.app | Override the gateway URL. |
Links
- MCP server: mcp.spraay.app
- Gateway: gateway.spraay.app
- Manifest: gateway.spraay.app/.well-known/x402.json
- Smithery: smithery.ai/servers/Plagtech/Spraay-x402-mcp
- x402: x402.org
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
X402_WALLET_PRIVATE_KEY*secretPrivate key for the wallet that pays for x402 requests (USDC on Base)
Categories
Registryactive
Packagespraay-x402-mcp
TransportSTDIO
AuthRequired
UpdatedMar 9, 2026
