Which integrations are available for this server?

Enables multi-chain JSON-RPC calls via the Alchemy platform to interact with various blockchain networks. Supports decentralized storage by allowing users to pin and retrieve content on the InterPlanetary File System (IPFS) via Pinata. Provides persistent storage for DeFi infrastructure data, including invoices, escrow milestones, audit trails, and webhook registrations.

How do I use Spraay x402 MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Spraay x402 MCP Server What is the USDC balance of vitalik.eth?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Spraay x402 MCP Server

Version Tools License: MIT

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

AI agent calls a tool (e.g. spraay_batch_execute)
MCP server hits the Spraay x402 Gateway
Gateway returns 402 Payment Required with USDC amount
@x402/axios auto-signs a USDC micropayment from your wallet
Gateway validates payment and returns data
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Spraay x402 MCP Server

Spraay x402 MCP Server

Quick Start

Claude Desktop

Cursor

Smithery

From Source

57 Tools — 15 Categories

AI ($0.001–$0.005)

Payments ($0.001–$0.01)

DeFi — Swap ($0.001–$0.01)

Oracle ($0.001–$0.003)

Bridge ($0.001–$0.005)

Payroll ($0.001–$0.02)

Invoice ($0.001–$0.005) — persistent

Analytics ($0.003–$0.005)

Escrow ($0.001–$0.008) — persistent

AI Inference ($0.008–$0.01)

Communication ($0.001–$0.005)

Infrastructure ($0.001–$0.005)

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

Compliance ($0.001–$0.02) — persistent

Data ($0.001–$0.002)

How It Works

Requirements

Environment Variables

Links

License

Resources

Latest Blog Posts

MCP directory API