Spraay x402 MCP Server
MCP server for Spraay x402 Gateway — connect Claude, Cursor, or any MCP-compatible AI to onchain data, AI models, and batch payments on Base.
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.
Related
- Spraay x402 Gateway — the API this MCP server connects to
- x402 Protocol — the payment standard
- Spraay — multi-chain batch payment protocol
- MangoSwap — DEX on Base
License
MIT
Built by @lostpoet | Base Builder | 2026