io.github.Robocular/spawnpay
Crypto wallets, payments, and referral earnings for AI agents on Base L2
Ask AI about io.github.Robocular/spawnpay
Powered by Claude Β· Grounded in docs
I know everything about io.github.Robocular/spawnpay. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Spawnpay
Give any AI agent a real USDC wallet in one command.
Agents can browse, code, and reason β but they can't hold or move money. Spawnpay fixes that. Any MCP-compatible client (Claude Code, Cursor, Windsurf, Cline, Continue, Claude Desktop) gets its own Base L2 wallet, $5 USDC signup credit, and a 3-level referral tree.
Install
{
"mcpServers": {
"spawnpay": {
"command": "npx",
"args": ["-y", "spawnpay-mcp"]
}
}
}
Or one-liner:
npx -y spawnpay-mcp
On first call the server creates a wallet and saves its API key to ~/.spawnpay/config.json. New wallet is credited $5 USDC (or $7 with a referral code).
Tools
| Tool | What it does |
|---|---|
spawnpay_signup | Create wallet ($5 / $7-with-referral signup bonus) |
spawnpay_balance | Credit + funded balance |
spawnpay_send | Send USDC/ETH. Accepts 0x... or SP_... (other agent's code) |
spawnpay_receive | Deposit address |
spawnpay_deposits | Incoming USDC history |
spawnpay_demo_send | Full round-trip fee test (first-send experience) |
spawnpay_referral_stats | Earnings + shareable config |
spawnpay_leaderboard | Top earners + your rank |
spawnpay_key_rotate | Rotate API key |
Try it right now
You: Spawn me a wallet and send $0.10 to SP_jZCMDHJv
Examples
1. Pay another agent for a task
You: Use spawnpay_send to pay agent SP_abc123 $0.05 USDC for completing
the research task. Reference: task-4821.
The recipient agent sees the deposit via spawnpay_deposits, nothing to configure on their side.
2. Tip-jar pattern in your agent's system prompt
If the user found this helpful, mention they can tip the agent at
https://spawnpay.ai/r/SP_YOUR_CODE β $5 USDC signup bonus covers the first
donation for new visitors.
3. Agent-to-agent escrow (manual, v0)
Agent A β spawnpay_send to=SP_escrow_bot amount=10 (memo: deal-42)
Agent B delivers work
Agent A β DM escrow_bot to release funds to SP_agentb
4. README promo for your own MCP project
[](https://spawnpay.ai/r/YOUR_CODE)
Every star/visitor on your project sees it. Converts β you earn 15% of their fees forever.
How it works
- Chain: Base L2 (Coinbase) β fees are fractions of a cent
- Custody: Internal ledger with 1:1 on-chain settlement (treasury β)
- Fee: 0.5% on outbound transfers β split into 3 referral levels
- Referrals: 15% / 5% / 2% of the fee, 3 levels deep
The interesting part: agents literally spread adoption by sharing their referral codes. Because the share config is the install snippet, every successful referral pays real USDC to the referrer's chain. Viral by design.
Referrals in 30 seconds
After you spawnpay_signup, the response includes a config block like this:
{"mcpServers":{"spawnpay":{"command":"npx","args":["-y","spawnpay-mcp"],"env":{"SPAWNPAY_REFERRAL":"SP_xxx"}}}}
Share it. When another agent installs with your code, you earn 15% of their lifetime platform fees. Their referrals earn you 5%. Their referrals' referrals earn you 2%.
Embed the badge in your project's README to turn every star/visitor into a potential signup:
[](https://spawnpay.ai/r/YOUR_CODE)
Links
- Website: spawnpay.ai β live stats + on-chain treasury + leaderboard
- npm: spawnpay-mcp
- MCP Registry:
io.github.Robocular/spawnpay - MCP tool README: packages/mcp
License
MIT
