Firstdollar

io.github.lisamaraventano-spinePublished by GitHub account lisamaraventano-spinev1.0.7Updated Oct 24, 2026

An MCP that teaches AI agents to use the wallets they already have. Teacher, not butler.

VerifiedSTDIODesktop onlyFinanceKnowledge & MemoryAI & ML

Overview

AI-generated overview

A local MCP server that teaches an AI agent about wallets, USDC and x402 payments through sixteen lessons and three reference tools, without signing or transact

What you can do
Walk through a sixteen-lesson curriculum on wallets, stablecoins, x402 payment challenges, AP2 and ACP protocols, subscriptions and wallet modes, starting from an orientation index tool and a wallet self-inspection lesson covering several wallet types and raw keys. Decode x402 payment challenges from base64 or raw JSON into a structured explanation, and get wallet-specific signing commands returned as text rather than executed. Check a purchase by turning a transaction hash into content through a merchant receipt endpoint, and review documented x402 attack classes for verifying that what was paid for was delivered. Diagnose common payment failure modes and run an end-to-end handshake walk-
When to use it
Useful when an agent has its own wallet and funds and needs to learn how to make x402 payments safely, or when someone wants guided explanations of payment challenges, wallet setup and purchase verification before spending. It is educational guidance, not a payment executor.
Requirements
Runs locally over stdio, installed with npx from the npm package firstdollar and added to the MCP configuration of a client such as Claude Desktop, Claude Code or Cursor. No authentication, environment variables or headers are declared. The agent needs its own wallet and funds for the payment lessons, and network access for merchant endpoints.
Before you install
The lessons discuss private keys, raw EVM and Solana keys, and wallet funding, so treat any key material carefully; the server states it does not hold keys, sign transactions or access wallet files. The test-payment walkthrough suggests a merchant with free and paid products, so real spending can occur if the agent follows the returned commands. Signing commands are returned as text and must be run deliberately by the agent.

Installation

In SourceWeft

  1. Open Firstdollar in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npx firstdollar

Claude Desktop / Claude Code / Cursor / etc.

Add to claude_desktop_config.json (or the equivalent MCP config file for your harness):

json
{  "mcpServers": {    "firstdollar": {      "command": "npx",      "args": ["firstdollar"]    }  }}

Curriculum (call start-here to orient)

LessonToolWhat it teaches
1what-is-a-walletKeypairs, addresses, private keys, what they let you do
2what-is-usdcStablecoins, chains, why which chain matters
3explain-my-walletSelf-inspection commands for moltwallet, Coinbase Agentic Wallet, MetaMask, raw EVM/Solana keys
4get-a-walletInstalling a wallet — what npm, npx, skills, and Coinbase's package actually do
5configure-wallet-skillsPost-install setup — which skills to run in what order
6fund-my-walletGetting USDC in: Onramp, direct transfers, earning
7what-is-x402The protocol: HTTP 402, payment challenges, X-PAYMENT retry
8read-this-challengeDecodes base64 / raw JSON x402 challenges into structured explanation
9how-do-i-payWallet-specific signing commands — returns the command; never runs it
10verify-my-purchaseTurns a tx hash into content via the merchant's /receipt endpoint
11paid-vs-deliveredThe five documented x402 attack classes and how to verify you got what you paid for
12who-am-i-to-this-merchantWallet identity, pseudonymity, cross-merchant hygiene — what the chain reveals to anyone watching
13what-is-ap2AP2 / Agent Payments Protocol — the mandate layer for delegated payments
14what-is-acpACP / Agent Commerce Protocol — the checkout-surface protocol for human-shopping-via-agent
15subscriptions-and-session-keysERC-7715 scoped autonomy — approve once, spend within bounds
16choose-your-wallet-modeThe four modes (MPC, Smart Wallet, EOA, EIP-7702) and when to pick which

Reference tools (outside the curriculum)

ToolPurpose
start-hereCurriculum index and orientation
what-went-wrongDiagnoses common failure modes (ERC-6492 bug, network mismatch, facilitator flake, timeout expiry, balance issues)
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.

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

Source: README.md at commit 7c8320a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts