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

MCP server for

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

9 Tools Available

Tool	Cost	What It Does
`spraay_chat`	$0.005	AI chat via 200+ models (GPT-4, Claude, Llama, Gemini)
`spraay_models`	$0.001	List available AI models with pricing
`spraay_batch_execute`	$0.01	Batch USDC payments to multiple recipients
`spraay_batch_estimate`	$0.001	Estimate gas for batch payments
`spraay_swap_quote`	$0.002	Uniswap V3 swap quotes on Base
`spraay_tokens`	$0.001	List supported tokens on Base
`spraay_prices`	$0.002	Live onchain token prices (Uniswap V3)
`spraay_balances`	$0.002	ETH + ERC-20 balances for any address
`spraay_resolve`	$0.001	Resolve ENS names and Basenames to addresses

Quick Start

1. Clone and Install

git clone https://github.com/plagtech/spraay-x402-mcp.git cd spraay-x402-mcp npm install npm run build

2. Configure Claude Desktop

Add to your Claude Desktop config:

{ "mcpServers": { "spraay": { "command": "node", "args": ["/absolute/path/to/spraay-x402-mcp/dist/index.js"], "env": { "EVM_PRIVATE_KEY": "0xYourPrivateKeyWithUSDCOnBase" } } } }

3. Configure Cursor

Add to .cursor/mcp.json in your project:

{ "mcpServers": { "spraay": { "command": "node", "args": ["/absolute/path/to/spraay-x402-mcp/dist/index.js"], "env": { "EVM_PRIVATE_KEY": "0xYourPrivateKeyWithUSDCOnBase" } } } }

4. Restart and Use

Restart Claude Desktop or Cursor. Then just ask:

"What is the current price of ETH on Base?" -> calls spraay_prices
"Check the USDC balance of vitalik.eth" -> calls spraay_resolve then spraay_balances
"Get me a swap quote for 100 USDC to WETH" -> calls spraay_swap_quote
"Send 10 USDC each to these 5 addresses" -> calls spraay_batch_execute

Environment Variables

Variable	Required	Description
EVM_PRIVATE_KEY	Yes	Private key of a wallet with USDC on Base mainnet
SPRAAY_GATEWAY_URL	No	Gateway URL (default: https://gateway.spraay.app)

How Payments Work

You ask Claude -> Claude calls spraay_prices tool | MCP server hits gateway.spraay.app/api/v1/prices | Gateway returns HTTP 402 + payment requirements | x402 client auto-signs $0.002 USDC payment | Retries request with payment proof | Gateway verifies payment, returns live prices | Claude shows you the data

Your wallet pays USDC on Base for each tool call. Payments are instant and verifiable onchain.