Junto Mcp

Junto

为人和 Agent 打造的支付协议。

通过任意 AI 助手收发款项。支持任何支付渠道。内置安全护栏。

名称源自 Benjamin Franklin 的 Junto——一个商人共同建设公共基础设施的社团。不同的服务提供商，同一张桌子，互惠共赢。

---

为什么

AI 助手开始处理真实资金——支付发票、分摊账单、转账。但每家支付服务提供商都有不同的 API、不同的身份验证方式和不同的结算时间。没人应该费心教助手 Pix、Stripe 和 Wise 各自如何运作。

Junto 通过一个 MCP 服务解决这个问题，它可以：

• 向任何兼容 MCP 的客户端（Claude、Cursor、自定义 Agent）提供通用支付工具集
• 根据币种、国家和支付渠道，路由到合适的服务提供商
• 强制执行支出限额，防止 Agent 越权操作
• 支持高额交易的人在回路确认
• 记录每项操作，以便审计和问责

工具

工具	描述
pay	向指定目的地汇款（Pix 密钥、电子邮件、IBAN 等）
charge	创建付款请求／发票／二维码
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 [email protected]
junto charge 10.00 "Coffee"
junto balance

以 MCP 服务运行（供 AI 客户端使用）：

junto --mcp

葡萄牙语 / Portugues

Junto 会自动检测系统语言，也可以手动设置：

JUNTO_LANG=pt-BR junto ajuda
junto pagar 25.00 [email protected]
junto cobrar 10.00 "Cafe"
junto saldo

有关两种语言的完整命令参考，请参阅 CLI.md。

添加到 Claude Desktop 或 Cursor

{
  "mcpServers": {
    "junto": {
      "command": "npx",
      "args": ["-y", "junto-mcp"],
      "env": {
        "WOOVI_APP_ID": "your-woovi-app-id"
      }
    }
  }
}

完成。你的 AI 助手现在可以使用支付工具了。

安全护栏

所有金额均以分（最小货币单位）为单位。

设置	环境变量	默认值	含义
每日限额	JUNTO_DAILY_LIMIT	50000 (R$500)	每日最高总支出
单笔交易上限	JUNTO_PER_TX_MAX	20000 (R$200)	单笔交易最高金额
超过此金额需确认	JUNTO_CONFIRM_ABOVE	5000 (R$50)	发送前询问人工
允许的服务提供商	JUNTO_ALLOWED_PROVIDERS	(全部)	以逗号分隔的允许列表
允许的目的地	JUNTO_ALLOWED_DESTINATIONS	(全部)	以逗号分隔的类型允许列表

当 Agent 尝试发送超过 JUNTO_CONFIRM_ABOVE 阈值的金额时，服务会暂停并返回确认提示词。Agent 必须将此提示转达给用户，并在继续操作前获得批准。

⚠️ Confirmation required

  Amount:      BRL 150.00
  To:          [email protected]
  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、银行卡	🟡 下一步
Belvo	巴西	开放金融（所有银行）	🟡 下一步
Stripe	全球	银行卡、ACH、SEPA	🟡 下一步
Wise	全球	银行转账	🔴 计划中
Mercado Pago	拉美	Pix、银行卡	🔴 计划中
PayPal	全球	基于电子邮件	🔴 计划中

为什么先支持 Woovi/Pix？

• Pix 即时结算（非常适合演示和实际使用）
• 巴西中央银行要求支付服务提供商提供开放 API
• 2025 年有超过 1.8 亿 Pix 用户、超过 800 亿笔交易
• Pix Automático（于 2025 年 6 月推出）支持定期付款
• 手续费低，无中间商
• **已验证：**付款请求、状态查询和付款流程均已使用真实 Pix 交易测试（2026 年 3 月）

演示

You:   "Pay R$25 to [email protected] via Pix"

Agent:  I'll send the following payment:
          Amount: R$ 25,00
          To: [email protected] (Pix)
          Via: Woovi
        Shall I go ahead?

You:   "Yes"

Agent:  Done! Payment sent.
          Amount: R$ 25,00
          To: [email protected]
          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 <correlation-id>

# Send a Pix payment
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts pay 100 [email protected] EMAIL

# Refund
WOOVI_APP_ID=your-key npx tsx test/live-pix.ts refund <correlation-id>

交互式演示

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": "[email protected]",
  "status": "executed"
}

路线图

• 具备通用工具接口的核心 MCP 服务
• Woovi/OpenPix 提供方（Pix）——已通过真实交易进行在线测试
• 防护措施（日限额、单笔交易上限、HITL 确认）
• 审计账本
• junto-skill（Claude 行为层）
• 交互式演示（npx tsx demo/demo.ts）
• Ebanx 提供方（Pix 付款、Boleto、银行卡——巴西 + 拉美）
• Belvo 提供方（开放金融——覆盖所有巴西银行）
• Stripe 提供方（银行卡、ACH、SEPA）
• junto-approve（通过 Telegram/WhatsApp 进行 HITL 确认）
• junto-dashboard（用于查看交易历史和限额的网页 UI）
• junto-compute（Agent 之间的预算委派）
• AP2 兼容层（Google Agent Payments Protocol）
• Wise 提供方（国际银行转账）

参与贡献

我们需要以下方面的帮助：

• 提供方适配器——Ebanx、Stripe、Wise、Belvo、Mercado Pago、PayPal、UPI
• 路由逻辑——根据最便宜、最快或最可靠的标准选择提供方
• HITL 模式——适用于不同 MCP 客户端的审批流程
• 安全审计——审查防护措施和身份验证系统
• 多币种——外汇处理、跨境路由
• 文档——各地区的合规与监管指南

许可证

MIT