spawnpay-mcp

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

• On first use, the server auto-creates a wallet via the Spawnpay API
• Credentials are saved to ~/.spawnpay/config.json
• All subsequent calls use the saved API key
• 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