moneydevkit
Add payments to any web app in under 5 minutes. Two supported frameworks: Next.js and Replit (Express + Vite).
Workflow
1. Get credentials
Option A — MCP:
There are two MCP servers:
- - Unauthenticated (
/mcp/) — for creating a new account and minting credentials - Authenticated (
/mcp/account/) — for managing your account after setup (requires OAuth)
To create a new account:
CODEBLOCK0
After you have credentials, switch to the authenticated MCP for full account control:
CODEBLOCK1
Option B — CLI:
CODEBLOCK2
Option C — Dashboard:
Sign up at moneydevkit.com and create an app.
All options produce two values:
- -
MDK_ACCESS_TOKEN — API key - INLINECODE3 — wallet seed phrase
Add both to .env (or Replit Secrets, Vercel env vars, etc.). Both are required.
2. Pick a framework and follow its guide
3. Create products (optional)
For fixed catalog items, create products via the dashboard or MCP:
mcporter call moneydevkit.create-product name="T-Shirt" priceAmount=2500 currency=USD
Then use
type: 'PRODUCTS' checkouts with the product ID.
For dynamic amounts (tips, donations, invoices), skip products and use type: 'AMOUNT' directly.
4. Deploy
Deploy to Vercel (Next.js) or Replit. Ensure MDK_ACCESS_TOKEN and MDK_MNEMONIC are set in the production environment.
⚠️ Use printf not echo when piping env vars — trailing newlines cause silent auth failures.
Checkout types
| Type | Use case | Required fields |
|---|
| INLINECODE11 | Dynamic amounts, tips, invoices | INLINECODE12 , INLINECODE13 |
| INLINECODE14 |
Sell dashboard products |
product (product ID) |
Pricing options
- - Fixed price — set specific amount (USD cents or whole sats)
- Pay what you want — customer chooses amount (set
amountType: 'CUSTOM' on product)
Currency
- -
USD — amounts in cents (e.g. 500 = $5.00) - INLINECODE18 — amounts in whole satoshis
Customers
Collect customer info to track purchases and enable refunds:
CODEBLOCK4
MCP tools
If the moneydevkit MCP server is connected (authenticated), these tools are available:
- -
create-app / list-apps / update-app / rotate-api-key — manage apps - INLINECODE23 /
list-products / get-product / update-product / INLINECODE27 - INLINECODE28 /
list-customers / get-customer / update-customer / INLINECODE32 - INLINECODE33 /
get-checkout — view checkout sessions - INLINECODE35 /
get-order — view completed payments - INLINECODE37 — search moneydevkit documentation
Security
⚠️ MDK_MNEMONIC is a wallet seed phrase — treat it like a private key.
- - Never commit it to git or share in chat messages
- Never log it in application output or error handlers
- Use environment variables or a secrets manager (Vercel env vars, Replit Secrets, AWS Secrets Manager, etc.)
- For production: prefer separate apps with limited-scope keys rather than reusing one mnemonic across projects
- The mnemonic controls the Lightning wallet that receives payments — if compromised, funds can be stolen
- Test with signet/testnet credentials first before using mainnet
MDKACCESSTOKEN is an API key scoped to your app. Rotate it via the dashboard or MCP (rotate-api-key) if compromised.
External endpoints used by this skill:
- -
mcp.moneydevkit.com — MCP server for account management (HTTPS, OAuth) - INLINECODE40 — documentation
Source code: @moneydevkit on npm · docs.moneydevkit.com
Docs
Full documentation: docs.moneydevkit.com
moneydevkit
在5分钟内为任何Web应用添加支付功能。支持两种框架:Next.js和Replit(Express + Vite)。
工作流程
1. 获取凭证
选项A — MCP:
有两个MCP服务器:
- - 未认证(/mcp/)— 用于创建新账户并生成凭证
- 已认证(/mcp/account/)— 用于设置完成后管理账户(需要OAuth)
创建新账户:
claude mcp add moneydevkit --transport http https://mcp.moneydevkit.com/mcp/
获取凭证后,切换到已认证的MCP以完全控制账户:
claude mcp add moneydevkit --transport http https://mcp.moneydevkit.com/mcp/account/
选项B — CLI:
bash
npx @moneydevkit/create
选项C — 控制面板:
在 moneydevkit.com 注册并创建应用。
所有选项都会生成两个值:
- - MDKACCESSTOKEN — API密钥
- MDK_MNEMONIC — 钱包助记词
将两者添加到 .env(或Replit Secrets、Vercel环境变量等)。两者都是必需的。
2. 选择框架并按照指南操作
3. 创建产品(可选)
对于固定目录项,通过控制面板或MCP创建产品:
mcporter call moneydevkit.create-product name=T恤 priceAmount=2500 currency=USD
然后使用带有产品ID的 type: PRODUCTS 结账。
对于动态金额(小费、捐赠、发票),跳过产品直接使用 type: AMOUNT。
4. 部署
部署到Vercel(Next.js)或Replit。确保在生产环境中设置了 MDKACCESSTOKEN 和 MDK_MNEMONIC。
⚠️ 传递环境变量时使用 printf 而非 echo — 尾部换行会导致静默认证失败。
结账类型
| 类型 | 使用场景 | 必填字段 |
|---|
| AMOUNT | 动态金额、小费、发票 | amount、currency |
| PRODUCTS |
销售控制面板产品 | product(产品ID) |
定价选项
- - 固定价格 — 设置具体金额(美分或整聪)
- 随心支付 — 客户选择金额(在产品上设置 amountType: CUSTOM)
货币
- - USD — 金额以美分为单位(例如500 = $5.00)
- SAT — 金额以整聪为单位
客户
收集客户信息以跟踪购买并支持退款:
ts
await createCheckout({
// ...结账字段
customer: { email: jane@example.com, name: Jane, externalId: user-123 },
requireCustomerData: [email, name] // 显示缺失字段的表单
})
MCP工具
如果已连接(已认证)moneydevkit MCP服务器,则可以使用以下工具:
- - create-app / list-apps / update-app / rotate-api-key — 管理应用
- create-product / list-products / get-product / update-product / delete-product
- create-customer / list-customers / get-customer / update-customer / delete-customer
- list-checkouts / get-checkout — 查看结账会话
- list-orders / get-order — 查看已完成支付
- search-docs — 搜索moneydevkit文档
安全
⚠️ MDK_MNEMONIC是钱包助记词 — 请像对待私钥一样对待它。
- - 切勿提交 到git或在聊天消息中分享
- 切勿记录 在应用输出或错误处理器中
- 使用 环境变量 或 密钥管理器(Vercel环境变量、Replit Secrets、AWS Secrets Manager等)
- 生产环境:建议使用 具有有限作用域密钥的独立应用,而非在项目间重复使用同一个助记词
- 助记词控制接收支付的闪电网络钱包 — 如果泄露,资金可能被盗
- 在使用主网之前,先用signet/testnet凭证进行测试
MDKACCESSTOKEN 是作用域限定于你的应用的API密钥。如果泄露,可通过控制面板或MCP(rotate-api-key)轮换。
此技能使用的外部端点:
- - mcp.moneydevkit.com — 用于账户管理的MCP服务器(HTTPS、OAuth)
- docs.moneydevkit.com — 文档
源代码: npm上的@moneydevkit · docs.moneydevkit.com
文档
完整文档:docs.moneydevkit.com