mcpField
M
mcp-nubank

mcp-nubank

ローカル
github.com/codespar金融データ2754 週間前に更新
リポジトリ

mcp-nubank について

mcp-nubank は、Open Finance Brasil 標準に基づいて Nubank を操作する MCP サーバーです。README によると、呼び出し先の api.nubank.com.br が DNS で解決できず、現在は利用可能なエンドポイントがないため、このプロジェクトは非推奨になっています。

主な機能

  1. 01口座、残高、取引、請求書の照会
  2. 02PIX 送金、予約送金、PIX キー管理
  3. 03デビットカードとクレジットカードの照会、ブロック、解除
  4. 04mTLS 証明書を用いた OAuth2 クライアント認証情報フロー

活用シーン

  1. 01Nubank 向け MCP サーバーのツール設計の参考
  2. 02利用可能なエンドポイントを設定した後の再接続

MCP 対応

本プロジェクトは MCP サーバーであり、口座照会や PIX、カード操作を含む 22 個のツールを MCP クライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-nubank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-nubank"
      ],
      "env": {
        "NUBANK_CLIENT_ID": "<NUBANK_CLIENT_ID>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-nubank
設定が必要な環境変数
NUBANK_CLIENT_IDシークレットAPI key/token for nubank

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-nubank0.2.0-alpha.4

ツール

22

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

@codespar/mcp-nubank

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に、2 つの公開 DNS リゾルバー（8.8.8.8 と 1.1.1.1）を使って確認したところ、このサーバーが呼び出すホスト api.nubank.com.br は DNS で名前解決できませんでした。確認できた Nubank の公開 API は NuPay for Business（api.spinpay.com.br）のみで、これは @codespar/mcp-nupay ですでに対応しています。このサーバーのツールは、いずれもサービスに接続できません。このパッケージは npm で非推奨になっており、参照用としてのみこのリポジトリに残しています。使用可能なエンドポイントをお持ちの場合は、NUBANK_BASE_URL を使ってサーバーの接続先を指定してください。パッケージの再公開を希望する場合は、プロバイダーの公式ドキュメントに記載されたベース URL を添えて、mcp-dev-latam にイシューを作成してください。

Open Finance Brasil 標準を使用する、ブラジル最大のデジタル銀行 Nubank 向け MCP サーバーです。

npm License: MIT

アルファ版リリース — npm の alpha dist-tag で公開されています。エンドポイントのパスは公開ドキュメントと BACEN／プロバイダーの規約に準拠していますが、ライブ環境での検証は完了していません。0.x.x-alpha の間は、正確なバージョンを指定してください。npm install @codespar/mcp-nubank@alpha でインストールできます。

クイックスタート

# Set your credentials
export NUBANK_CLIENT_ID="your-client-id"
export NUBANK_CLIENT_SECRET="your-client-secret"
export NUBANK_CERT_PATH="/path/to/certificate.pem"

# Run via stdio
npx -y @codespar/mcp-nubank@alpha

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-nubank@alpha

環境変数

変数必須説明
NUBANK_CLIENT_IDはいOAuth2 クライアント ID
NUBANK_CLIENT_SECRETはいOAuth2 クライアントシークレット
NUBANK_CERT_PATHはいmTLS 証明書ファイルのパス
MCP_HTTPいいえHTTP トランスポートを有効にするには "true" を設定します
MCP_PORTいいえHTTP ポート（デフォルト：3000）

ツール（22）

ツール用途
get_accountsすべての口座（当座、貯蓄）を一覧表示します
get_balance口座残高を取得します
get_transactionsフィルターを指定して取引を一覧表示します
get_credit_card_billクレジットカードの請求内容を取得します
get_investments投資と利回りを一覧表示します
initiate_pixPIX 送金を開始します
get_pix_keys登録済みの PIX キーを一覧表示します
get_statement指定期間の口座明細を取得します
get_profile認証済みユーザーのプロフィール情報を取得します
list_cardsデビットカードとクレジットカードを一覧表示します
get_pix_transfer特定の PIX 送金のステータスと詳細を取得します
schedule_pix将来の日付で PIX 送金を予約します
cancel_scheduled_pix予約済みの PIX 送金をキャンセルします
create_pix_key認証済み口座に新しい PIX キーを登録します
delete_pix_key登録済みの PIX キーを削除します
get_card_detailsデビットカードまたはクレジットカード1枚の詳細を取得します
block_cardカードをブロックします（紛失・盗難の報告、または一時的な利用停止）
unblock_card以前ブロックしたカードのブロックを解除します（一時ブロックの場合のみ有効）
get_credit_card_transactions指定したクレジットカードの請求に関する取引を一覧表示します
pay_credit_card_bill紐づけられた口座からクレジットカードの請求を支払います
get_boletoバーコードまたは数字入力行から boleto の詳細を取得します
pay_boleto紐づけられた口座から boleto を支払います

認証

mTLS 証明書を使用する OAuth2 クライアントクレデンシャル フローを利用します。認証情報を取得するには、Nubank の Open Finance ポータルからアプリケーションを登録してください。

API リファレンス

エンタープライズ

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

認証

サーバーを起動する前に、次の環境変数を設定してください。

  • NUBANK_CLIENT_ID (必須、シークレット) — nubank の API キー／トークン

認証情報はプロバイダーの開発者ポータルで発行してください：https://openfinancebrasil.org.br。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。