mcp-unblockpay

@codespar/mcp-unblockpay

UnblockPay 用の MCP サーバー — 顧客 → ウォレット → 見積もり → 入金／出金による法定通貨 ↔ ステーブルコインの国際送金

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

Claude Code

claude mcp add unblockpay -- npx @codespar/mcp-unblockpay

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

ツール（13）

ツール	用途
create_customer	個人または法人の顧客を作成します（KYC の起点）。法人顧客には date_of_incorporation が必要です。
list_customers	オペレーターの API キーに紐づく顧客を一覧表示します（v1 のページネーション仕様により limit は必須です）。
verify_customer	KYC 認証チェックを開始します。冪等性があり、すでに承認済みの場合は 422 customer_cannot_be_verified を返します。
get_verification_details	KYC の状態を確認します。customer_status: pending | approved | rejected | partially_rejected を返します。
create_wallet	承認済みの顧客に紐づくステーブルコインウォレットを作成します。
list_wallets	オペレーターの API キーに紐づくウォレットを一覧表示します。
create_external_account	法定通貨の受取口座を登録します（BRL Pix、USD 電信送金、EUR SEPA、MXN SPEI）。BRL Pix の出金では、create_payout の pix_key + document ショートカットを使えば省略できます。
list_external_accounts	オペレーターの API キーに紐づく外部口座を一覧表示します。
create_quote	FX レートと手数料の見積もりを 5 分間固定します。sender または receiver のどちらか一方に amount を指定し、両方には指定しないでください。
create_payin	quote_id を参照して法定通貨をステーブルコインに入金します。入金手順（ブラジルの場合は <Pix Copy & Paste EMV>）を返します。
create_payout	quote_id を参照してステーブルコインを法定通貨で出金します。最上位階層の customer_id は必須です。
get_transaction	取引の状態を確認します。ライフサイクル：awaiting_deposit → processing → completed（または failed / refunded / cancelled / error）。
cancel_transaction	取引をキャンセルします。状態が awaiting_deposit の場合にのみ有効です。

認証

UnblockPay では、Authorization ヘッダーに API キーをそのまま渡します（Bearer プレフィックスは不要です）。サーバーがヘッダーを設定するため、UNBLOCKPAY_API_KEY でキーを指定するだけです。

サンドボックス／テスト

UnblockPay はテスト用に別のサンドボックス環境を提供しています。UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1 を設定し、サンドボックス用に発行された API キーを使用して、サーバーの接続先を切り替えます。

認証情報を取得する

1. app.unblockpay.com にサインインします（または ドキュメント を確認します）
2. ダッシュボードで API キーを生成します
3. UNBLOCKPAY_API_KEY 環境変数を設定します
4. （サンドボックスのみ）UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1 も設定します

環境変数

変数	必須	説明
UNBLOCKPAY_API_KEY	はい	UnblockPay ダッシュボードで取得した API キー
UNBLOCKPAY_BASE_URL	いいえ	デフォルトは https://api.unblockpay.com/v1 です。サンドボックスを使用する場合は https://api.sandbox.unblockpay.com/v1 に設定します。

ロードマップ

上記の 13 個のツールは、UnblockPay の現在の v1 API に対応しています。UnblockPay の機能が拡張されるのに合わせて、新しいツールが追加されます。

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• UnblockPay のウェブサイト
• UnblockPay API ドキュメント
• MCP Dev LatAm
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT