一起
个人和代理人的支付协议。
通过任何AI助手发送和接收资金。任何付款方式。内置护栏。
以。。命名 [本杰明·富兰克林的军队]() --共同建设市政基础设施的商人社会。不同的供应商，同一张桌子，互惠互利。
______________________________________________________________________
为什么
人工智能助手开始转移真钱——支付发票、拆分账单、发送转账。但每个支付提供商都有不同的API、不同的授权、不同的结算时间。没有人应该教他们的助手Pix、Stripe和Wise是如何工作的。
Junto用一个MCP服务器修复了这个问题，该服务器：
- 暴露a 通用支付工具包 任何MCP兼容客户端（Claude、Cursor、自定义代理）
- 前往的路线 正确的提供者 基于货币、国家和铁路
- 强制执行 支出限额 所以特工们不能胡作非为
- 支持 人在循环 大额交易确认
- 日志 每一个行动 审计和问责制
工具
| 工具 | 说明 |
|---|---|
pay | 向目的地汇款（Pix密钥、电子邮件、IBAN等） |
charge | 创建付款请求/发票/QR码 |
status | 通过关联ID检查付款状态 |
refund | 撤销已完成的交易 |
balance | 检查提供商的可用资金 |
providers | 列出已配置的提供程序及其功能 |
limits | 显示支出限制和今天的使用情况 |
快速开始
npm install -g junto-mcp设置提供商API密钥：
export WOOVI_APP_ID="your-woovi-app-id"以CLI（人工模式）运行：
junto pay 25.00 maria@email.com
junto charge 10.00 "Coffee"
junto balance作为MCP服务器运行（适用于AI客户端）：
junto --mcp葡萄牙语/葡萄牙语
Junto自动检测您的系统语言，或手动设置：
JUNTO_LANG=pt-BR junto ajuda
junto pagar 25.00 maria@email.com
junto cobrar 10.00 "Cafe"
junto saldo看 CLI.md 这两种语言的完整命令参考。
添加到Claude桌面或光标
{
"mcpServers": {
"junto": {
"command": "npx",
"args": ["-y", "junto-mcp"],
"env": {
"WOOVI_APP_ID": "your-woovi-app-id"
}
}
}
}就是这样。你的人工智能助手现在有了支付工具。
护栏
所有金额均以 分 （最小货币单位）。
| 设置 | 环境变量 | 默认值 | 含义 |
|---|---|---|---|
| 每日限额 | JUNTO_DAILY_LIMIT | 50000（500雷亚尔） | 每天最大总支出 |
| 每tx最大值 | JUNTO_PER_TX_MAX | 20000（200雷亚尔） | 最大单笔交易 |
| 以上确认 | JUNTO_CONFIRM_ABOVE | 5000（50雷亚尔） | 发送前询问人类 |
| 允许的提供者 | JUNTO_ALLOWED_PROVIDERS | _（全部）_ | 逗号分隔的异体字 |
| 允许的目的地 | JUNTO_ALLOWED_DESTINATIONS | _（全部）_ | 逗号分隔类型满列表 |
当代理试图发送上述内容时 JUNTO_CONFIRM_ABOVE 阈值，服务器暂停并返回确认提示。代理必须将此信息转发给用户，并在继续之前获得批准。
⚠️ Confirmation required
Amount: BRL 150.00
To: maria@email.com
Reason: Amount (15000 cents) exceeds confirmation threshold (5000 cents)
Please confirm with the user before proceeding.建筑
┌─────────────────────────────────────┐
│ MCP Client (Claude, Cursor, etc.) │
└──────────────┬──────────────────────┘
│ MCP Protocol (stdio)
┌──────────────▼──────────────────────┐
│ junto-mcp │
│ │
│ ┌───────────┐ ┌────────────────┐ │
│ │ Router │ │ Guardrails │ │
│ │ (picks │ │ (spend caps, │ │
│ │ provider) │ │ HITL confirm, │ │
│ │ │ │ audit log) │ │
│ └─────┬─────┘ └────────────────┘ │
│ │ │
│ ┌─────▼─────────────────────────┐ │
│ │ Provider Adapters │ │
│ │ ┌────────┐ ┌──────┐ ┌────┐ │ │
│ │ │ Woovi │ │Stripe│ │Wise│ │ │
│ │ └────────┘ └──────┘ └────┘ │ │
│ └───────────────────────────────┘ │
│ │
│ ┌───────────────────────────────┐ │
│ │ Audit Ledger (JSONL) │ │
│ └───────────────────────────────┘ │
└─────────────────────────────────────┘提供商
| 提供者 | 区域 | 轨道 | 状态 |
|---|---|---|---|
| Woovi/OpenPix | 巴西 | Pix | 🟢 实时（使用真实Pix交易进行测试） |
| Ebanx | 巴西+拉丁美洲 | Pix支付、Boleto、卡 | 🟡 下一个 |
| 贝尔沃 | 巴西 | 开放金融（所有银行） | 🟡 下一个 |
| 条纹 | 全球 | 卡、ACH、SEPA | 🟡 下一个 |
| 明智 | 全球 | 银行转账 | 🔴 计划中 |
| Mercado支付 | LATAM | 像素，卡片 | 🔴 计划中 |
| 贝宝 | 全球 | 基于电子邮件 | 🔴 计划中 |
为什么首先选择Woovi/Pix？
- Pix安定下来 立即 （非常适合演示和实际使用）
- 巴西央行要求开放支付API
- 2025年，像素用户数超过1.8亿，交易量超过8000亿
- Pix Automatico（于2025年6月推出）支持定期支付
- 费用低，无中介
- 已证实的： 使用真实Pix交易测试收费、状态和支付流（2026年3月）
演示
You: "Pay R$25 to maria@email.com via Pix"
Agent: I'll send the following payment:
Amount: R$ 25,00
To: maria@email.com (Pix)
Via: Woovi
Shall I go ahead?
You: "Yes"
Agent: Done! Payment sent.
Amount: R$ 25,00
To: maria@email.com
Via: Pix (Woovi)
Status: Completed
ID: junto-1739612345-a1b2c3添加提供者
每个提供者都是一个实现 PaymentProvider 接口：
// src/providers/your-provider.ts
import { PaymentProvider } from "../types.js";
export class YourProvider implements PaymentProvider {
name = "your-provider";
supportedCurrencies = ["USD"];
supportedRails = ["card"];
settlementTime = "1-3 days";
async pay(req) { /* send money */ }
async charge(req) { /* create invoice */ }
async status(id) { /* check status */ }
async refund(id) { /* reverse payment */ }
async balance() { /* check funds */ }
info() { /* return capabilities */ }
}复制 src/providers/_template.ts 若要开始，请在中注册您的提供商 src/index.ts.
测试
npm test # Guardrail unit tests
npm run test:smoke # Full flow smoke tests (mock provider)使用真实Pix进行实时测试
# Create a Pix charge (R$1.00)
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts charge 100 "Test charge"
# Check status
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts status
# Send a Pix payment
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts pay 100 user@email.com EMAIL
# Refund
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts refund 互动演示
npx tsx demo/demo.ts # Full demo with typewriter narration + real API calls
npx tsx demo/demo.ts --fast # Fast mode for rehearsals审计日志
每笔交易都记录到 ~/.junto/audit-YYYY-MM-DD.jsonl:
{
"timestamp": "2026-02-15T14:32:07Z",
"type": "payment",
"action": "pay",
"tool": "pay",
"amount": 2500,
"currency": "BRL",
"provider": "woovi",
"destination": "maria@email.com",
"status": "executed"
}路线图
- \[x\] 带通用工具接口的核心MCP服务器
- \[x\] Woovi/OpenPix提供商（Pix）-- 通过真实交易进行现场测试
- \[x\] 护栏（每日限额，每交易上限，HITL确认）
- \[x\] 审计台账
- \[x\] junto技能（克劳德行为层）
- \[x\] 互动演示(
npx tsx demo/demo.ts) - \[\]Ebanx提供商（Pix支付、Boleto、卡——巴西+拉丁美洲）
- \[\]Belvo提供商（开放金融——所有巴西银行）
- \[\]条纹提供商（卡、ACH、SEPA）
- \[\]junto批准（HITL的电报/WhatsApp确认）
- \[\]junto仪表板（交易历史和限额的web UI）
- \[\]junto compute（代理对代理预算委托）
- \[\]AP2兼容层（谷歌代理支付协议）
- \[\]明智的提供商（国际银行转账）
贡献
我们需要帮助：
- 提供商适配器 --Ebanx、Stripe、Wise、Belvo、Mercado Pago、PayPal、合众社
- 路由逻辑 --最便宜、最快、最可靠的供应商选择
- HITL图案 --不同MCP客户端之间的审批流
- 安全审计 --护栏和认证系统的审查
- 多种货币 --外汇处理、跨境路由
- 文档 --每个地区的合规和监管指南
许可证
麻省理工学院