Spraay X402 Mcp

plagtech/spraay-x402-mcp

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.

tools: 80
auth: Secret needed
transport: STDIO
env var: 1
last updated: Mar 9, 2026

View on GitHub

Tools

80 tools

Public tool metadata for what this MCP can expose to an agent.

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

messagestring

User message to send to the model

modelstring

Model 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

systemPromptstring

Optional 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

amountsarray

Array of amounts in token units (e.g. '100' for 100 USDC). Must match recipients length.

recipientsarray

Array of 1-200 recipient wallet addresses

senderstring

Sender wallet address that will sign the transaction

tokenstring

Token symbol (e.g. 'USDC', 'ETH', 'WETH', 'DAI') or ERC-20 contract address on Base

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

recipientCountnumber

Number of recipients (1-200)

tokenstring

Token symbol (default: USDC)

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

amountInstring

Amount to swap in human-readable units (e.g. '1000' for 1000 USDC)

tokenInstring

Input token symbol (e.g. 'USDC', 'WETH', 'DAI') or contract address

tokenOutstring

Output 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

amountInstring

Amount to swap in human-readable units

recipientstring

Recipient address for swap output (e.g. '0xYourWallet')

slippagenumber

Slippage tolerance in percent (default: 0.5, max: 50)

tokenInstring

Input token symbol (e.g. 'USDC') or contract address

tokenOutstring

Output token symbol (e.g. 'WETH') or contract address

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

tokensstring

Comma-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

basestring

Base 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

amountstring

Amount in smallest units (e.g. '1000000' for 1 USDC with 6 decimals)

fromAddressstring

Sender wallet address on source chain

fromChainstring

Source chain name (e.g. 'base', 'ethereum', 'arbitrum', 'polygon')

toChainstring

Destination chain name (e.g. 'ethereum', 'arbitrum', 'polygon')

tokenstring

Token symbol to bridge (e.g. 'USDC', 'ETH')

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

employeesarray

Array of 1-200 employee payment objects

senderstring

Employer/sender wallet address

tokenstring

Payment token symbol (e.g. 'USDC', 'USDT', 'DAI')

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

employeeCountnumber

Number of employees to pay (1-200)

tokenstring

Payment token symbol (default: 'USDC')

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

amountstring

Invoice amount in human-readable units (e.g. '1500.00' for $1500)

creatorstring

Invoice creator/payee wallet address (e.g. '0xYourAddress')

dueDatestring

Payment deadline in ISO 8601 format (e.g. '2026-04-15')

memostring

Invoice description/memo (e.g. 'Web development - March 2026')

recipientstring

Payer address — omit for open invoice (anyone can pay)

tokenstring

Payment token symbol (e.g. 'USDC', 'USDT', 'DAI', 'EURC', 'WETH')

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

addressstring

Creator or payer address to filter by (e.g. '0xYourAddress')

statusstring

Filter by invoice statusone of pending · paid · expired · cancelled

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

idstring

Invoice 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

addressstring

Wallet 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

addressstring

Wallet address to get history for

limitstring

Max transactions to return (default: '10', max: '100')

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

amountstring

Escrow amount in human-readable units (e.g. '5000.00')

arbiterstring

Optional third-party arbiter who can release or cancel

beneficiarystring

Beneficiary/freelancer address who receives funds on release

conditionsarray

Milestone conditions (e.g. ['Design approved', 'Dev complete'])

depositorstring

Depositor/client address who will fund the escrow

expiresInnumber

Expiry in hours (1-8760, default: 168 = 7 days)

tokenstring

Token symbol (e.g. 'USDC', 'USDT', 'DAI', 'EURC', 'WETH')

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

addressstring

Address to list escrows for (depositor, beneficiary, or arbiter)

statusstring

Filter by escrow statusone of created · funded · released · cancelled · expired

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

idstring

Escrow 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

escrowIdstring

Escrow 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

callerstring

Caller address — must be depositor or arbiter

escrowIdstring

Escrow 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

callerstring

Caller address — must be depositor (or arbiter for funded escrows)

escrowIdstring

Escrow 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

addressstring

Ethereum/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

hashstring

Transaction 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

addressstring

Contract 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

contextstring

Context hint to improve analysis (e.g. 'defi', 'nft', 'governance', 'bridge', 'mev')

targetstring

Address (0x..., 40 hex chars) or transaction hash (0x..., 64 hex chars) to summarize

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

bodystring

Email body content (plain text or HTML)

ccstring

CC email address

replyTostring

Reply-to email address

subjectstring

Email subject line

tostring

Recipient email address (e.g. 'user@example.com')

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

bodystring

SMS message body (max 1600 characters)

tostring

Phone number in E.164 format (e.g. '+14155551234')

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

idstring

Notification 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

eventsarray

Events to subscribe to (e.g. ['payment.sent', 'escrow.funded', 'swap.completed'])

urlstring

Webhook URL to receive POST events (e.g. 'https://yourapp.com/webhook')

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

webhookIdstring

Webhook 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

statusstring

Filter by webhook statusone of active · paused · failed

spraay_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

webhookIdstring

Webhook 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

contentstring

Message content to send

contentTypestring

Content type (default: 'text/plain')

tostring

Recipient Ethereum address (must have XMTP enabled)

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

addressstring

Ethereum address to check inbox for

limitstring

Max messages to return (default: '20', max: '100')

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

chainstring

Chain identifier (e.g. 'base', 'ethereum', 'arbitrum', 'polygon', 'bnb', 'avalanche', 'solana')

methodstring

JSON-RPC method (e.g. 'eth_getBalance', 'eth_blockNumber', 'eth_call', 'eth_getTransactionReceipt')

paramsarray

RPC 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

contentTypestring

MIME type (default: 'application/octet-stream', e.g. 'application/json', 'text/plain')

datastring

Content to pin — JSON string, plain text, or base64-encoded binary

providerstring

Storage provider (default: 'ipfs')one of ipfs · arweave

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

cidstring

Content 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

idstring

Pin 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

actionstring

Gateway action to schedule (e.g. 'batch.execute', 'swap.execute', 'notify.email', 'payroll.execute', 'xmtp.send')

maxRunsnumber

Max executions before auto-cancel (omit for unlimited)

payloadobject

Payload for the scheduled action (same format as the action's direct API call)

schedulestring

Cron 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

actionstring

Filter by action type (e.g. 'batch.execute')

statusstring

Filter by job statusone of active · paused · cancelled · completed

spraay_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

jobIdstring

Cron 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

entriesarray

Array 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

levelstring

Filter by log levelone of debug · info · warn · error

limitstring

Max results to return (default: '50', max: '500')

servicestring

Filter by service name (e.g. 'batch-agent')

sincestring

Start time in ISO 8601 format (e.g. '2026-03-01T00:00:00Z')

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

addressstring

Ethereum address to verify

levelstring

Verification level (default: 'basic')one of basic · enhanced · full

typestring

Verification type (default: 'individual')one of individual · business

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

addressstring

Ethereum address for lookup (alternative to ID)

idstring

KYC record ID (e.g. 'kyc_abc123')

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

addressstring

Ethereum address to create session for

permissionsarray

Scoped permissions array (e.g. ['batch:execute', 'swap:execute']). Omit or pass ['*'] for all permissions.

ttlSecondsnumber

Session TTL in seconds (60-86400, default: 3600 = 1 hour)

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

tokenstring

Session 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

actionstring

Action type (e.g. 'payment.sent', 'escrow.created', 'kyc.completed', 'auth.session_created')

actorstring

Actor wallet address who performed the action

detailsobject

Additional details as key-value pairs

resourcestring

Resource identifier (e.g. 'batch_123', 'ESC-A1B2', 'INV-C3D4')

txHashstring

Related on-chain transaction hash

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

actionstring

Filter by action type (e.g. 'payment.sent')

actorstring

Filter by actor wallet address

limitstring

Max results (default: '50', max: '500')

resourcestring

Filter by resource identifier (partial match)

sincestring

Start time in ISO 8601 (e.g. '2026-03-01T00:00:00Z')

untilstring

End time in ISO 8601

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

transactionsarray

Array 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

reportIdstring

Tax 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

inputobject

Model-specific input parameters. Image models: { prompt: '...' }. LLMs: { prompt: '...' }. Whisper: { audio: 'https://...' }. ESRGAN: { image: 'https://...' }.

modelstring

Model 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.

versionstring

Specific model version hash (optional — not needed for official models)

webhookstring

Webhook 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

idstring

Prediction 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

exclude_domainsarray

Exclude results from these domains

include_domainsarray

Only include results from these domains (e.g. ['docs.base.org', 'ethereum.org'])

max_resultsnumber

Number of results to return (default: 5, max: 20)

querystring

Search query (e.g. 'latest Base ecosystem developments', 'x402 protocol explained')

search_depthstring

Search depth: 'basic' (fast, default) or 'advanced' (deeper extraction, better results)one of basic · advanced

topicstring

Topic focus: 'general' (default), 'news' (recent events), 'finance' (markets/crypto)one of general · news · finance

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

urlsarray

Array 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

querystring

Natural language question (e.g. 'What is x402 protocol and how does it work?')

topicstring

Topic focus: 'general' (default), 'news', 'finance'one of general · news · finance

spraay_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

tokenstring

Specific 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

addressstring

Wallet address to check (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')

showAllstring

Set to 'true' to include zero balancesone of true · false

tokensstring

Comma-separated custom ERC-20 contract addresses to include

spraay_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

namestring

ENS 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

paramsstring

Query parameters as JSON (e.g. {"key":"value"})

spraay_robots_registerRegister Robot (RTP) | [RTP (Robotics)] | FREE1 params

Parameters* required

bodystring

JSON request body

spraay_robots_completeReport Task Complete (RTP) | [RTP (Robotics)] | FREE1 params

Report Task Complete (RTP) | [RTP (Robotics)] | FREE

Parameters* required

bodystring

JSON request body

spraay_robots_updateUpdate Robot (RTP) | [RTP (Robotics)] | FREE1 params

Update Robot (RTP) | [RTP (Robotics)] | FREE

Parameters* required

bodystring

JSON request body

spraay_robots_deregisterRemove Robot (RTP) | [RTP (Robotics)] | FREE1 params

Remove Robot (RTP) | [RTP (Robotics)] | FREE

Parameters* required

bodystring

JSON request body

spraay_bittensor_healthBittensor health | [Bittensor] | FREE1 params

Bittensor health | [Bittensor] | FREE

Parameters* required

paramsstring

Query 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

bodystring

JSON request body

spraay_robots_listDiscover robots | [RTP (Robotics)] | $0.005 USDC1 params

Discover robots | [RTP (Robotics)] | $0.005 USDC

Parameters* required

paramsstring

Query 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

paramsstring

Query 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

paramsstring

Query 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

bodystring

JSON 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

bodystring

JSON request body

spraay_agent_wallet_infoAgent wallet info | [Agent Wallets] | $0.005 USDC1 params

Agent wallet info | [Agent Wallets] | $0.005 USDC

Parameters* required

paramsstring

Query 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

bodystring

JSON request body

Configuration

X402_WALLET_PRIVATE_KEY*secret

Private key for the wallet that pays for x402 requests (USDC on Base)

Readme

💧 Spraay x402 MCP Server

View the full README on GitHub

Details

Repository: github.com/plagtech/spraay-x402-mcp
Category: Finance & Commerce
Package: spraay-x402-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Finance & Commerce MCP servers

View all

Robinhood (Agentic Trading)robinhoodOfficial Robinhood MCP server for agentic trading. Connect any AI agent to a dedicated, sandboxed Agentic account: it can read your accounts, positions, and ord0stars

Maker AI MCProcnubie/makerai-mcpCreate product photos, product videos, and UGC-style ads for Shopify, Amazon, TikTok, and0stars

Deepnets — Solana Token Intelligencescifantastic/deepnets-mcpSolana token intelligence for trading agents: safety, holder graphs, funding networks, research.0stars

Apollo Intelligencebnmbnmai/mcp-proxy36 tools: intel feeds, DeFi, crypto, OSINT, NLP, scraping, proxy. x402 micropayments.0stars

Tradestaq Mcpthe-staq/tradestaq-mcpAI-powered crypto trading tools. Strategies, backtests, bots, and portfolio management.0stars

Robokassa Mcptheyahia/robokassa-mcpMCP server for Robokassa payment API — generate payment URLs, check invoice status. First MCP for R0stars

Spraay X402 Mcp

Tools

Configuration

Readme

💧 Spraay x402 MCP Server

Details

More from plagtech

Related Finance & Commerce MCP servers