Junto Mcp

Junto

人とエージェントのための決済プロトコルです。

あらゆる AI アシスタントから、あらゆる決済手段で送金・受け取りができます。ガードレールも組み込み済みです。

Benjamin Franklin の Juntoにちなんで名付けられました。Junto は、職人たちが共に市民インフラを築いた会です。異なるプロバイダーが同じテーブルを囲み、互いに利益をもたらします。

---

理由

AI アシスタントは、請求書の支払い、割り勘、送金など、実際のお金を扱い始めています。しかし、決済プロバイダーごとに API、認証、決済完了までの時間が異なります。Pix と Stripe と Wise の仕組みを、アシスタントにいちいち教える必要はありません。

Junto は、次の機能を備えた単一の MCP サーバーでこの問題を解決します。

• あらゆる 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 [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 アシスタントから決済ツールを利用できるようになります。

ガードレール

金額はすべてセント（通貨の最小単位）で指定します。

設定	環境変数	デフォルト	意味
1 日あたりの限度額	JUNTO_DAILY_LIMIT	50000 (R$500)	1 日あたりの支出総額の上限
取引ごとの上限	JUNTO_PER_TX_MAX	20000 (R$200)	1 回の取引の上限
確認が必要な金額	JUNTO_CONFIRM_ABOVE	5000 (R$50)	送金前に人間へ確認を求める金額
許可するプロバイダー	JUNTO_ALLOWED_PROVIDERS	(すべて)	カンマ区切りの許可リスト
許可する送金先	JUNTO_ALLOWED_DESTINATIONS	(すべて)	カンマ区切りの種類の許可リスト

エージェントが JUNTO_CONFIRM_ABOVE のしきい値を超える金額を送金しようとすると、サーバーは処理を一時停止し、確認プロンプトを返します。エージェントはこれをユーザーに伝え、承認を得てから処理を進める必要があります。

⚠️ 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	ブラジル + LATAM	Pix の支払い、Boleto、カード	🟡 次に対応予定
Belvo	ブラジル	オープンファイナンス（全銀行）	🟡 次に対応予定
Stripe	グローバル	カード、ACH、SEPA	🟡 次に対応予定
Wise	グローバル	銀行振込	🔴 対応予定
Mercado Pago	LATAM	Pix、カード	🔴 対応予定
PayPal	グローバル	メールベース	🔴 対応予定

まず Woovi/Pix に対応する理由

• Pix は即時に決済が完了します（デモにも実利用にも最適です）
• ブラジル中央銀行は、決済のためのオープン API を義務付けています
• 2025 年には Pix の利用者が 1 億 8,000 万人以上、取引件数が 800 億件以上に達しました
• 2025 年 6 月に開始した Pix Automático により、定期支払いが可能になります
• 手数料が低く、仲介業者が不要です
• **検証済み：**チャージ、ステータス確認、支払いの各フローは、実際の 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、カード — ブラジル＋LATAM）
• Belvo プロバイダー（オープンファイナンス — ブラジルの全銀行）
• Stripe プロバイダー（カード、ACH、SEPA）
• junto-approve（HITL のための Telegram/WhatsApp による確認）
• junto-dashboard（取引履歴と上限を確認する Web UI）
• junto-compute（エージェント間の予算委任）
• AP2 互換レイヤー（Google Agent Payments Protocol）
• Wise プロバイダー（国際銀行送金）

コントリビューション

以下の分野で協力を求めています。

• プロバイダーアダプター — Ebanx、Stripe、Wise、Belvo、Mercado Pago、PayPal、UPI
• ルーティングロジック — 最安、最速、または最も信頼性の高いプロバイダーの選択
• HITL パターン — さまざまな MCP クライアントに対応した承認フロー
• セキュリティ監査 — ガードレールと認証システムのレビュー
• マルチカレンシー — 為替処理、国境を越えたルーティング
• ドキュメント — 地域ごとのコンプライアンスおよび規制ガイド

ライセンス

MIT