Firstdollar

io.github.lisamaraventano-spine由 GitHub 帳號 lisamaraventano-spine 發布v1.0.7更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融知識與記憶AI 與機器學習

概覽

AI 產生的概覽

一個本機 MCP 伺服器，透過十六堂課和三個參考工具教 AI 代理認識錢包、USDC 與 x402 支付，本身不簽章也不交易。

可以做什麼
依十六堂課程說明錢包、穩定幣、x402 支付挑戰、AP2 與 ACP 協定、訂閱與錢包模式，並提供課程索引工具與涵蓋多種錢包類型及原始金鑰的錢包自檢課。將 base64 或原始 JSON 的 x402 支付挑戰解碼為結構化說明，並回傳針對特定錢包的簽章指令文字而不執行。透過商家收據端點把交易雜湊轉為內容以核對購買，並說明已記錄的 x402 攻擊類型以驗證是否收到所購內容。診斷常見支付失敗原因，並走查一次端對端握手流程。
適用情境
適合代理擁有自己的錢包和資金、需要學習如何安全進行 x402 支付時，或希望在花錢前取得支付挑戰、錢包設定與購買核驗的引導說明時使用。它是教學指引，不是支付執行器。
執行需求
以 stdio 在本機執行，透過 npx 從 npm 套件 firstdollar 安裝，並加入 Claude Desktop、Claude Code 或 Cursor 等用戶端的 MCP 設定。未宣告驗證、環境變數或標頭。支付課程需要代理擁有自己的錢包和資金，存取商家端點需要網路。
安裝前請注意
課程涉及私鑰、原始 EVM 與 Solana 金鑰以及錢包入金，須謹慎處理任何金鑰資料；伺服器聲明不持有金鑰、不簽章、不存取錢包檔案。test-payment 流程建議的商家含免費與付費商品，若代理執行回傳的指令可能產生真實支出。簽章指令以文字回傳，需由代理自行決定是否執行。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Firstdollar，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 7c8320a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.7最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分