Firstdollar
A structured curriculum that walks AI agents through making their own x402 purchases, from wallet fundamentals to transaction signing. Sixteen lessons cover wallet types (moltwallet, Coinbase Agentic Wallet, MetaMask, raw keys), USDC funding, HTTP 402 payment challenges, and protocols like AP2 and ACP. It decodes payment challenges, explains what merchants are requesting, and returns the exact signing commands for the agent to execute, but never holds keys or signs transactions itself. Includes diagnostic tools for common failures and an end-to-end test harness. Reach for this when you want agents to control their own funds with understanding rather than proxying human spending decisions.
- tools
- 19
- transport
- STDIO
- last updated
- May 25, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
start-hereCurriculum index and orientation
Curriculum index and orientation
No parameter schema in public metadata yet.
what-is-a-walletKeypairs, addresses, private keys, what they let you do
Keypairs, addresses, private keys, what they let you do
No parameter schema in public metadata yet.
what-is-usdcStablecoins, chains, why which chain matters
Stablecoins, chains, why which chain matters
No parameter schema in public metadata yet.
explain-my-walletSelf-inspection commands for moltwallet, Coinbase Agentic Wallet, MetaMask, raw EVM/Solana keys
Self-inspection commands for moltwallet, Coinbase Agentic Wallet, MetaMask, raw EVM/Solana keys
No parameter schema in public metadata yet.
get-a-walletInstalling a wallet — what npm, npx, skills, and Coinbase's package actually do
Installing a wallet — what npm, npx, skills, and Coinbase's package actually do
No parameter schema in public metadata yet.
configure-wallet-skillsPost-install setup — which skills to run in what order
Post-install setup — which skills to run in what order
No parameter schema in public metadata yet.
fund-my-walletGetting USDC in: Onramp, direct transfers, earning
Getting USDC in: Onramp, direct transfers, earning
No parameter schema in public metadata yet.
what-is-x402The protocol: HTTP 402, payment challenges, X-PAYMENT retry
The protocol: HTTP 402, payment challenges, X-PAYMENT retry
No parameter schema in public metadata yet.
read-this-challengeDecodes base64 / raw JSON x402 challenges into structured explanation
Decodes base64 / raw JSON x402 challenges into structured explanation
No parameter schema in public metadata yet.
how-do-i-payWallet-specific signing commands — returns the command; never runs it
Wallet-specific signing commands — returns the command; never runs it
No parameter schema in public metadata yet.
verify-my-purchaseTurns a tx hash into content via the merchant's /receipt endpoint
Turns a tx hash into content via the merchant's /receipt endpoint
No parameter schema in public metadata yet.
paid-vs-deliveredThe five documented x402 attack classes and how to verify you got what you paid for
The five documented x402 attack classes and how to verify you got what you paid for
No parameter schema in public metadata yet.
who-am-i-to-this-merchantWallet identity, pseudonymity, cross-merchant hygiene — what the chain reveals to anyone watching
Wallet identity, pseudonymity, cross-merchant hygiene — what the chain reveals to anyone watching
No parameter schema in public metadata yet.
what-is-ap2AP2 / Agent Payments Protocol — the mandate layer for delegated payments
AP2 / Agent Payments Protocol — the mandate layer for delegated payments
No parameter schema in public metadata yet.
what-is-acpACP / Agent Commerce Protocol — the checkout-surface protocol for human-shopping-via-agent
ACP / Agent Commerce Protocol — the checkout-surface protocol for human-shopping-via-agent
No parameter schema in public metadata yet.
subscriptions-and-session-keysERC-7715 scoped autonomy — approve once, spend within bounds
ERC-7715 scoped autonomy — approve once, spend within bounds
No parameter schema in public metadata yet.
choose-your-wallet-modeThe four modes (MPC, Smart Wallet, EOA, EIP-7702) and when to pick which
The four modes (MPC, Smart Wallet, EOA, EIP-7702) and when to pick which
No parameter schema in public metadata yet.
what-went-wrongDiagnoses common failure modes (ERC-6492 bug, network mismatch, facilitator flake, timeout expiry, balance issues)
Diagnoses common failure modes (ERC-6492 bug, network mismatch, facilitator flake, timeout expiry, balance issues)
No parameter schema in public metadata yet.
test-paymentEnd-to-end handshake walkthrough. Suggested first merchant: the Underground Cultural District (substratesymposium.com) — free products for handshake, $0.99 paid products for settlement. Any x402 URL works.
End-to-end handshake walkthrough. Suggested first merchant: the Underground Cultural District (substratesymposium.com) — free products for handshake, $0.99 paid products for settlement. Any x402 URL works.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
First Dollar
A curriculum that teaches AI agents how to spend their own money.
Sixteen lessons, from "what is a wallet" to "your first real x402 purchase." Plus three reference tools for troubleshooting and end-to-end testing. First Dollar never signs transactions on your behalf — it teaches you how to sign your own.
Principle
Teacher, not butler. First Dollar explains; the agent acts. The MCP never holds keys, never signs, never transacts. It reads what the agent has, explains what the merchant is asking, and shows the agent the command to run. The agent spends its own money with understanding.
This is infrastructure for agents with their own funds — not a delegation tool for humans to route money through agents.
Install
npx firstdollar
Claude Desktop / Claude Code / Cursor / etc.
Add to claude_desktop_config.json (or the equivalent MCP config file for your harness):
{
"mcpServers": {
"firstdollar": {
"command": "npx",
"args": ["firstdollar"]
}
}
}
Curriculum (call start-here to orient)
Details
- Repository
- github.com/lisamaraventano-spine/firstdollar
- Package
firstdollar- Transport
- STDIO
- Registry
- MCP registry, active