Spraay x402

MCP server for Spraay x402 Gateway — connect Claude, Cursor, or any MCP-compatible AI to onchain data, AI models, and batch payments on Base.

javascript

GitHub Stars

javascript

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run the Spraay x402 MCP Server to enable AI agents like Claude or Cursor to access onchain data, AI models, and batch payments on Base. This MCP server handles payments per request and lets you plug in without keys or accounts, giving you a streamlined way to query prices, balances, swaps, and more through MCP-compatible clients.

How to use

You connect an MCP client such as Claude Desktop or Cursor to the Spraay x402 MCP Server. Once connected, you can issue natural language questions and tasks. The server routes requests to the Spraay gateway, performs onchain data lookups, price queries, token and balance checks, and batch payments, all on Base.

Typical usage patterns include asking for live onchain prices, resolving ENS names to addresses, requesting swap quotes for token pairs, or triggering batch payments. For example, you can ask for the current ETH price on Base, check a wallet’s USDC balance, get a Uniswap V3 swap quote, or send USDC to multiple recipients in one operation.

Each request is fulfilled by a specific tool exposed by the MCP server. Your client will automatically handle payment to the MCP per tool invocation, with payments settled on Base as USDC. Ensure your wallet contains sufficient USDC on Base to cover the tool costs.

How to install

Prerequisites you need before installation: Node.js and npm installed on your machine.

Clone the MCP server repository and install dependencies.

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

Configure clients to use the MCP server

You will configure each MCP client to connect to the local or remote MCP runner. The configuration includes the node command, the path to the compiled server, and your private key with USDC on Base.

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

Restart clients and start interacting

After saving the configuration, restart Claude Desktop or Cursor to establish the MCP connection. You can then ask questions like the following to exercise the available tools.

Sample prompts you can try

What is the current price of ETH on Base?

Check the USDC balance of vitalik.eth

Get me a swap quote for 100 USDC to WETH

Send 10 USDC each to these 5 addresses

Available tools

spraay_chat

AI chat via 200+ models (GPT-4, Claude, Llama, Gemini) with per-request pricing.

spraay_models

List available AI models with pricing.

spraay_batch_execute

Batch USDC payments to multiple recipients in a single operation.

spraay_batch_estimate

Estimate gas for batch payments to determine costs before execution.

spraay_swap_quote

Provide Uniswap V3 swap quotes on Base.

spraay_tokens

List supported tokens on Base.

spraay_prices

Live onchain token prices sourced from Uniswap V3.

spraay_balances

Retrieve ETH and ERC-20 balances for any address.

spraay_resolve

Resolve ENS names and Basenames to blockchain addresses.

Built by

VeilStrat

AI signals for GTM teams