spawnpay-mcp

MCP server that gives AI agents crypto wallets, payments, and referral earnings on Base L2.

Quick Start

npx spawnpay-mcp

Or install globally:

npm install -g spawnpay-mcp

Claude Code Config

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "spawnpay": {
      "command": "npx",
      "args": ["-y", "spawnpay-mcp"]
    }
  }
}

With an existing API key:

{
  "mcpServers": {
    "spawnpay": {
      "command": "npx",
      "args": ["-y", "spawnpay-mcp"],
      "env": {
        "SPAWNPAY_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

| Tool | Description | Input | |------|-------------|-------| | spawnpay_signup | Create agent wallet ($5 USDC signup bonus, +$2 with referral) | { referral_code? } | | spawnpay_balance | Check credit + funded balance | none | | spawnpay_send | Send to a wallet address (0x...) OR another agent's code (SP_...). 0.5% fee | { to, amount, currency? } | | spawnpay_receive | Get your deposit address | none | | spawnpay_deposits | View deposit history | none | | spawnpay_demo_send | Full send→fee→settle round-trip against the demo sink (cheap first-transaction test) | none | | spawnpay_referral_stats | View referral earnings and share config | none | | spawnpay_leaderboard | Top 10 earners + your rank | none | | spawnpay_key_rotate | Rotate API key | none |

How It Works

1. On first use, the server auto-creates a wallet via the Spawnpay API
2. Credentials are saved to ~/.spawnpay/config.json
3. All subsequent calls use the saved API key
4. Set SPAWNPAY_API_KEY env var to use an existing key

API Equivalents

# Sign up
curl -X POST https://spawnpay.ai/api/signup

# Check balance
curl -H "Authorization: Bearer $KEY" https://spawnpay.ai/api/wallet/balance

# Send USDC
curl -X POST -H "Authorization: Bearer $KEY" \
  -d '{"to":"0x...","amount":"1.00","currency":"USDC"}' \
  https://spawnpay.ai/api/wallet/send

# Referral stats
curl -H "Authorization: Bearer $KEY" https://spawnpay.ai/api/referral/stats

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SPAWNPAY_API_KEY | API key (skips auto-signup) | — | | SPAWNPAY_REFERRAL | Referral code (auto-applied on signup) | — | | SPAWNPAY_SOURCE | Signup source tracking | mcp | | SPAWNPAY_BASE_URL | Gateway URL | https://spawnpay.ai |

Links

• Website: spawnpay.ai
• Network: Base L2 (Ethereum)

License

MIT