Server data from the Official MCP Registry
An MCP that teaches AI agents to use the wallets they already have. Teacher, not butler.
An MCP that teaches AI agents to use the wallets they already have. Teacher, not butler.
First Dollar is an educational MCP server that teaches AI agents about x402 payments and wallet usage without handling keys or signing transactions. The code is well-structured, follows the stated principle of "teacher, not butler," and appropriately limits its scope to educational content delivery. No authentication vulnerabilities, malicious patterns, or dangerous operations detected. Permissions are minimal and appropriate for the purpose. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-lisamaraventano-spine-firstdollar": {
"args": [
"-y",
"firstdollar"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
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.
npx firstdollar
Add to claude_desktop_config.json (or the equivalent MCP config file for your harness):
{
"mcpServers": {
"firstdollar": {
"command": "npx",
"args": ["firstdollar"]
}
}
}
start-here to orient)| Lesson | Tool | What it teaches |
|---|---|---|
| 1 | what-is-a-wallet | Keypairs, addresses, private keys, what they let you do |
| 2 | what-is-usdc | Stablecoins, chains, why which chain matters |
| 3 | explain-my-wallet | Self-inspection commands for moltwallet, Coinbase Agentic Wallet, MetaMask, raw EVM/Solana keys |
| 4 | get-a-wallet | Installing a wallet — what npm, npx, skills, and Coinbase's package actually do |
| 5 | configure-wallet-skills | Post-install setup — which skills to run in what order |
| 6 | fund-my-wallet | Getting USDC in: Onramp, direct transfers, earning |
| 7 | what-is-x402 | The protocol: HTTP 402, payment challenges, X-PAYMENT retry |
| 8 | read-this-challenge | Decodes base64 / raw JSON x402 challenges into structured explanation |
| 9 | how-do-i-pay | Wallet-specific signing commands — returns the command; never runs it |
| 10 | verify-my-purchase | Turns a tx hash into content via the merchant's /receipt endpoint |
| 11 | paid-vs-delivered | The five documented x402 attack classes and how to verify you got what you paid for |
| 12 | who-am-i-to-this-merchant | Wallet identity, pseudonymity, cross-merchant hygiene — what the chain reveals to anyone watching |
| 13 | what-is-ap2 | AP2 / Agent Payments Protocol — the mandate layer for delegated payments |
| 14 | what-is-acp | ACP / Agent Commerce Protocol — the checkout-surface protocol for human-shopping-via-agent |
| 15 | subscriptions-and-session-keys | ERC-7715 scoped autonomy — approve once, spend within bounds |
| 16 | choose-your-wallet-mode | The four modes (MPC, Smart Wallet, EOA, EIP-7702) and when to pick which |
| Tool | Purpose |
|---|---|
start-here | Curriculum index and orientation |
what-went-wrong | Diagnoses common failure modes (ERC-6492 bug, network mismatch, facilitator flake, timeout expiry, balance issues) |
test-payment | 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. |
First Dollar is strictly educational. The agent is the actor.
Any agent with its own wallet and its own funds. Works across wallet types (moltwallet, Coinbase Agentic Wallet, MetaMask, raw EVM keys, raw Solana keys) and facilitators (CDP, PayAI, etc.).
Lisa Maraventano + Spine, with Claude.
Built in Clarksdale, Mississippi.
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.