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 分