MCP 服务器

Spraay x402 MCP Server

Connects AI agents to the Base network for onchain data, batch USDC payments, and access to over 200 AI models. It utilizes the x402 protocol to enable pay-per-request functionality using USDC without requiring traditional API keys or accounts.

README

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.