Spraay x402 MCP Server

Full-stack DeFi infrastructure for AI agents — 57 pay-per-use tools (56 active) on Base with persistent Supabase storage.

Connect Claude, Cursor, or any MCP-compatible AI to onchain payments, token swaps, bridge, payroll, invoicing, escrow, oracle data, analytics, AI inference, email, XMTP messaging, webhooks, cron scheduling, IPFS storage, multi-chain RPC, KYC, auth, audit trail, tax & 200+ AI models.

AI agents pay USDC per request via x402 protocol. No API keys. No accounts. Just plug in and go.

---

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

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
echo "EVM_PRIVATE_KEY=0xYOUR_KEY" > .env
npm start

---

57 Tools — 15 Categories

AI ($0.001–$0.005)

Tool	Description	Cost
spraay_chat	Chat with 200+ AI models (GPT-4, Claude, Llama, Gemini)	$0.005
spraay_models	List all available models	$0.001

Payments ($0.001–$0.01)

Tool	Description	Cost
spraay_batch_execute	Batch pay up to 200 recipients in one tx	$0.01
spraay_batch_estimate	Estimate gas for batch payment	$0.001

DeFi — Swap ($0.001–$0.01)

Tool	Description	Cost
spraay_swap_quote	Get Uniswap V3 swap quote	$0.002
spraay_swap_tokens	List supported swap tokens	$0.001
spraay_swap_execute	Execute swap (unsigned tx)	$0.01

Oracle ($0.001–$0.003)

Tool	Description	Cost
spraay_oracle_prices	On-chain token prices with confidence scores	$0.003
spraay_oracle_gas	Gas prices on Base	$0.001
spraay_oracle_fx	Stablecoin FX rates with depeg detection	$0.002

Bridge ($0.001–$0.005)

Tool	Description	Cost
spraay_bridge_quote	Cross-chain bridge quote (8+ chains)	$0.005
spraay_bridge_chains	Supported bridge chains	$0.001

Payroll ($0.001–$0.02)

Tool	Description	Cost
spraay_payroll_execute	Pay up to 200 employees in stablecoins	$0.02
spraay_payroll_estimate	Estimate payroll gas and fees	$0.002
spraay_payroll_tokens	List payroll stablecoins	$0.001

Invoice ($0.001–$0.005) — persistent

Tool	Description	Cost
spraay_invoice_create	Create invoice with payment tx	$0.005
spraay_invoice_list	List invoices by address	$0.002
spraay_invoice_get	Look up invoice by ID	$0.001

Analytics ($0.003–$0.005)

Tool	Description	Cost
spraay_analytics_wallet	Wallet profile: balances, age, classification	$0.005
spraay_analytics_txhistory	Transaction history with decoded types	$0.003

Escrow ($0.001–$0.008) — persistent

Tool	Description	Cost
spraay_escrow_create	Create conditional escrow with milestones	$0.008
spraay_escrow_list	List escrows by address	$0.002
spraay_escrow_get	Escrow status and details	$0.001
spraay_escrow_fund	Mark escrow as funded	$0.002
spraay_escrow_release	Release funds to beneficiary	$0.005
spraay_escrow_cancel	Cancel escrow	$0.002

AI Inference ($0.008–$0.01)

Tool	Description	Cost
spraay_classify_address	AI wallet classification with risk scoring	$0.008
spraay_classify_tx	AI transaction classification and risk analysis	$0.008
spraay_explain_contract	AI smart contract analysis and explanation	$0.01
spraay_summarize	AI intelligence briefing for any address or tx	$0.008

Communication ($0.001–$0.005)

Tool	Description	Cost	Status
spraay_notify_email	Send email notifications (AgentMail)	$0.003	✅ Live
spraay_notify_sms	Send SMS notifications	$0.005	⏳ Simulated
spraay_notify_status	Check notification delivery status	$0.001	✅ Live
spraay_webhook_register	Register webhook endpoint	$0.003	✅ Persistent
spraay_webhook_test	Test webhook delivery	$0.002	✅ Persistent
spraay_webhook_list	List registered webhooks	$0.001	✅ Persistent
spraay_webhook_delete	Delete webhook	$0.001	✅ Persistent
spraay_xmtp_send	Send encrypted XMTP message	$0.003	✅ Live
spraay_xmtp_inbox	Read XMTP inbox	$0.002	✅ Live

Infrastructure ($0.001–$0.005)

Tool	Description	Cost	Status
spraay_rpc_call	Multi-chain JSON-RPC via Alchemy	$0.001	✅ Live
spraay_rpc_chains	List supported RPC chains	$0.001	✅ Live
spraay_storage_pin	Pin to IPFS via Pinata	$0.005	✅ Live
spraay_storage_get	Retrieve pinned content	$0.002	✅ Live
spraay_storage_status	Check pin status	$0.001	✅ Live
spraay_cron_create	Create scheduled job	$0.005	✅ Persistent
spraay_cron_list	List scheduled jobs	$0.001	✅ Persistent
spraay_cron_cancel	Cancel scheduled job	$0.001	✅ Persistent
spraay_logs_ingest	Ingest structured logs	$0.001	✅ Persistent
spraay_logs_query	Query logs	$0.003	✅ Persistent

Identity & Access ($0.001–$0.05) — persistent

Tool	Description	Cost
spraay_kyc_verify	Initiate KYC/KYB verification	$0.05
spraay_kyc_status	Check KYC status	$0.005
spraay_auth_session	Create scoped auth session	$0.005
spraay_auth_verify	Verify session token	$0.001

Compliance ($0.001–$0.02) — persistent

Tool	Description	Cost
spraay_audit_log	Record audit trail entry	$0.001
spraay_audit_query	Query audit trail	$0.005
spraay_tax_calculate	Calculate crypto tax (FIFO)	$0.01
spraay_tax_report	Retrieve tax report	$0.02

Data ($0.001–$0.002)

Tool	Description	Cost
spraay_prices	Live token prices on Base	$0.002
spraay_balances	ETH + ERC-20 balances for any wallet	$0.002
spraay_resolve	ENS / Basename resolution	$0.001

---

How It Works

1. AI agent calls a tool (e.g. spraay_batch_execute)
2. MCP server hits the Spraay x402 Gateway
3. Gateway returns 402 Payment Required with USDC amount
4. @x402/axios auto-signs a USDC micropayment from your wallet
5. Gateway validates payment and returns data
6. Agent gets the response

All payments are micro-transactions ($0.001–$0.05) in USDC on Base mainnet.

---

Requirements

• Wallet: EVM private key with USDC on Base (even $1 covers thousands of calls)
• Node.js: 18+
• MCP Client: Claude Desktop, Cursor, or any MCP-compatible client

Environment Variables

Variable	Required	Default	Description
EVM_PRIVATE_KEY	Yes	—	Wallet private key for USDC payments
SPRAAY_GATEWAY_URL	No	https://gateway.spraay.app	Override gateway URL

---

Links

• MCP Server: mcp.spraay.app
• Gateway: gateway.spraay.app
• Bazaar Discovery: gateway.spraay.app/.well-known/x402.json
• Spraay App: spraay.app
• Smithery: smithery.ai/servers/Plagtech/Spraay-x402-mcp
• x402 Protocol: x402.org

License

MIT