Spraay — Claude Code MCP server: what it does, how to install
Spraay equips AI agents with 183 DeFi and inference tools powered by the x402 payment protocol using USDC micropayments on Base.
MIT 1,864 installs ★ 4 updated 2026-07-01
claude mcp add --transport http spraay-x402-mcp https://spraay-x402-mcp--plagtech.run.toolsWhat Spraay does
Spraay links agents to onchain services and compute endpoints. The server exposes 183 tools covering batch payouts for up to 200 recipients, decentralized token swaps, milestone escrow, automated payroll runs, and wallet forensics. Beyond financial tasks, it offers search across 250M+ academic papers and API access to over 200 language models.
Billing relies on the x402 protocol, charging per invocation directly in USDC. Per-call costs range from $0.001 for read queries up to roughly $0.10 for heavy tasks like payroll distribution or escrow settlement. A group of 24 endpoints remains free, covering unit conversions, address checks, and status lookups.
Running locally generates a hot wallet in ~/.spraay/.session. The initial wallet starts empty, so paid operations will fail unless that address holds USDC on Base.
What it helps with
- distribute batch token payouts to multiple recipient addresses
- query token prices across DEX aggregators and trigger token swaps
- initialize milestone escrow contracts and verify transaction history
- explain smart contract byte code and classify unknown wallet addresses
Example prompts for the agent
- Check the current gas prices and exchange rates using spraay_oracle_gas.
- Prepare a batch transfer of USDC to these wallet addresses using Spraay.
- Summarize transaction history and classify address activity via Spraay.
How to install Spraay
Platform CLI: remote server
claude mcp add --transport http spraay-x402-mcp https://spraay-x402-mcp--plagtech.run.toolsPlatform CLI: remote server
codex mcp add spraay --url https://spraay-x402-mcp--plagtech.run.toolsConfig file
{
"mcpServers": {
"spraay": {
"url": "https://spraay-x402-mcp--plagtech.run.tools"
}
}
}Config file
{
"servers": {
"spraay": {
"type": "http",
"url": "https://spraay-x402-mcp--plagtech.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http spraay https://spraay-x402-mcp--plagtech.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Spraay
How to install Spraay in Claude Code?
Run claude mcp add --transport http spraay https://spraay-x402-mcp--plagtech.run.tools in your terminal.
What does Spraay do?
It connects coding agents to DeFi actions, token transfers, escrow systems, and inference APIs via pay-per-request micropayments in USDC.
Does Spraay require funding to test?
Testing free endpoints like gas checks and address validation requires no funds. Executing paid tools requires sending USDC on Base to the session address.