# Spraay

Spraay equips AI agents with 183 DeFi and inference tools powered by the x402 payment protocol using USDC micropayments on Base.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1864 installs · ★ 4 repo stars
- Author: plagtech
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/plagtech/spraay-x402-mcp
- Updated: 2026-07-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/spraay

## What it 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.

## Requirements
- Remote server: `https://spraay-x402-mcp--plagtech.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http spraay-x402-mcp https://spraay-x402-mcp--plagtech.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add spraay --url https://spraay-x402-mcp--plagtech.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spraay": {
            "url": "https://spraay-x402-mcp--plagtech.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spraay": {
            "type": "http",
            "url": "https://spraay-x402-mcp--plagtech.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http spraay https://spraay-x402-mcp--plagtech.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [clicks-protocol](https://affpapa.org/en/nevibecode/mcp/clicks-protocol.md) — MCP server · 532 installs
- [Coal - Payments for AI agents](https://affpapa.org/en/nevibecode/mcp/coal-payments-for-ai-agents.md) — MCP server · 1558 installs
- [xenarch-mcp](https://affpapa.org/en/nevibecode/mcp/xenarch-mcp.md) — MCP server · 974 installs
- [FiatDock](https://affpapa.org/en/nevibecode/mcp/fiatdock.md) — MCP server · ★ 1 repo stars
- [Agents Trust](https://affpapa.org/en/nevibecode/mcp/agents-trust.md) — MCP server
- [mcp](https://affpapa.org/en/nevibecode/mcp/walletbureau-mcp.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
