Spraay X402 MCP

What plagtech/spraay-x402-mcp MCP server does

plagtech/spraay-x402-mcp MCP server exposes Spraay Gateway operations through MCP tools. The documented server includes 183 tools across areas such as Base payments, payroll, invoicing, escrow, swaps, bridge quotes, oracle data, wallet analytics, transaction analysis, contract explanations, and AI model access. The live gateway manifest is the source for the current catalog and pricing, so the available tool set may change as the project synchronizes with that manifest.

Payment-oriented tools can create unsigned transaction data for a caller to sign rather than broadcasting transactions directly. Examples include batch transfers to as many as 200 recipients, token swaps, payroll runs, and escrow releases. Other tools provide estimates, token or chain lists, invoice records, escrow status, wallet profiles, decoded transaction history, and onchain price or gas information.

How it works

An MCP client invokes a tool, and the local server forwards the request to the Spraay x402 Gateway. The gateway returns a payment requirement, after which the request is settled in USDC before the result is returned. Tool charges vary by operation; the README states that pricing ranges from $0.001 for inexpensive reads to approximately $0.10 for some payroll, escrow, or tax operations. Twenty-four gateway endpoints are described as free.

In local mode, the server signs the USDC micropayment with a wallet created during first startup or with a private key supplied through configuration. In remote mode, the client connects to the hosted MCP URL and settlement is handled by the gateway, so no signing key is kept on the client machine.

Setup and configuration

Install the plagtech/spraay-x402-mcp MCP server with Node.js 20 or later:

npx -y spraay-x402-mcp

The package requires no environment variables for a basic local run. On first startup it creates a wallet, stores the session at ~/.spraay/.session, and prints the wallet address. Fund that address with USDC on Base before using paid calls. The optional EVM_PRIVATE_KEY variable replaces the generated wallet, while SPRAAY_GATEWAY_URL changes the gateway endpoint.

Claude Desktop and Cursor can launch the server with the same npx -y spraay-x402-mcp command. A hosted endpoint is also documented at https://spraay-x402-mcp--plagtech.run.tools.

Tools and capabilities

Representative capabilities include:

• Discover and call more than 200 AI models through spraay_models and spraay_chat.
• Quote and prepare Uniswap V3 swaps on Base, including token discovery.
• Estimate and prepare batch payments, payroll transfers, and escrow actions.
• Create, list, and inspect persistent invoices and escrows.
• Retrieve Base token prices, gas data, stablecoin FX rates, wallet profiles, and transaction history.
• Request bridge quotes across supported networks through the LI.FI aggregator.
• Classify addresses and transactions, explain verified contracts, and produce wallet or transaction summaries.

Limitations and notes

The plagtech/spraay-x402-mcp MCP server can control funds when a funded local wallet is used. Protect ~/.spraay/.session, use a dedicated hot wallet, and avoid placing a raw private key in committed configuration. A fresh wallet starts empty, although read-only tools can still be used.

Tool results and availability depend on the live gateway manifest. Operations that return unsigned transactions still require the caller to sign and broadcast them. Local use requires USDC on Base to pay for metered requests; remote mode avoids storing a signing key locally but still uses the gateway's settlement process.