First Dollar
FreeMaintainedA curriculum that teaches AI agents how to spend their own money. Sixteen lessons from "what is a wallet" to your first x402 purchase. Teacher, not butler — nev
About
A curriculum that teaches AI agents how to spend their own money. Sixteen lessons from "what is a wallet" to your first x402 purchase. Teacher, not butler — never signs, pays, or holds keys.
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.
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)
| 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 |
Reference tools (outside the curriculum)
| 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. |
What First Dollar does NOT do
- Does not hold private keys
- Does not sign transactions on your behalf
- Does not access your wallet files
- Does not have preferential routing to any merchant
- Does not enable humans to delegate wallets to agents for unauthorized spending
First Dollar is strictly educational. The agent is the actor.
Built for
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.).
Credits
Lisa Maraventano + Spine, with Claude.
Built in Clarksdale, Mississippi.
License
MIT
Install First Dollar in Claude Desktop, Claude Code & Cursor
unyly install first-dollarInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add first-dollar -- npx -y firstdollarStep-by-step: how to install First Dollar
FAQ
Is First Dollar MCP free?
Yes, First Dollar MCP is free — one-click install via Unyly at no cost.
Does First Dollar need an API key?
No, First Dollar runs without API keys or environment variables.
Is First Dollar hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install First Dollar in Claude Desktop, Claude Code or Cursor?
Open First Dollar on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Changes
Versions and requested access over time.
- New version published
- New version published
- New version published
- New version published
- New version published
- New version published
- New version published
- New version published
Related MCPs
Opencode Omniroute Plugin
OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc
by GitHub ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
by paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
by S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
by lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare First Dollar with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
