mcp-btg について
mcp-btg は、BTG Pactual 向けの MCP サーバーで、Pix、ボレト、口座情報、CDB・LCI・LCA・ファンドなどの投資商品を扱います。現在はアルファ版で、エンドポイントのパスはプロバイダーのポータル仕様とまだ照合されていません。BTG と契約済みの加盟店やフィンテック事業者を想定し、OAuth2 と mTLS の両方で認証します。
主な機能
- 01Pix 即時請求の作成と照会
- 02ボレトの発行と取得
- 03当座口座の残高と明細の照会
- 04定期預金・投資ポジションの一覧取得
- 05ファンドの申込・解約とファンド一覧の取得
- 06OAuth2 client_credentials と mTLS による認証
活用シーン
- 01エージェントによる Pix 請求の作成と入金状況の確認
- 02フィンテックのワークフローにおける口座残高と明細の照会
- 03CDB・LCI・LCA などの固定収益ポジションの一覧表示
MCP 対応
このプロジェクトは MCP サーバーであり、Pix、ボレト、口座、投資に関する操作を 12 個のツールとして MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-btgBTG_CLIENT_IDBTG OAuth client_id issued via the Developer Portal after contract onboarding.BTG_CLIENT_SECRETシークレットBTG OAuth client_secret.BTG_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2; BTG enforces it across product families.BTG_KEY_PATHシークレットAbsolute path to the mTLS private key (.key or .pem).BTG_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
12掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
@codespar/mcp-btg
BTG Pactual 向け MCP サーバー — ブラジル（およびラテンアメリカ）最大の投資銀行です。
BTG は、機関投資家向け証券仲介の基盤上で、デジタルバンキングと投資のサービス群（BTG+）を運営しています。加盟店やフィンテック企業は、Pix／boleto の決済基盤と、個人向け銀行ではここまで幅広く提供されていない投資口座 API（CDB、LCI、LCA、社債、ファンド）を組み合わせて利用するため、BTG と連携しています。
ステータス：アルファ（0.1.0-alpha.1）
BTG の Developer Portal は契約締結が必要です。完全な OpenAPI 仕様は、オンボーディング済みの取引先のみが閲覧できます。このサーバーのエンドポイントパスは、（a）BACEN Pix v2 の標準パス、（b）BTG の公開マーケティングページ、（c）他のブラジルの銀行と共通する規約に基づく推定です。未検証のパスには、ソース内で TODO(verify) のフラグが付いています。
0.1.x の期間中は厳密なバージョンに固定してください。オンボーディング済みの取引先が検証でき次第、ポータルの仕様に合わせてパスを修正します。
ツール（12）
| ツール | 目的 |
|---|---|
get_oauth_token | BTG Developer Portal 用の OAuth2 client_credentials ベアラートークンを発行するか、キャッシュ済みのトークンを返します。 |
create_pix_cob | QR コード付きの即時 Pix 請求（cob）を作成します。 |
get_pix_cob | txid を指定して即時 Pix 請求（cob）を取得します。 |
create_boleto | BTG Cobrança 経由で boleto を発行します。 |
get_boleto | BTG の識別子（id または nosso_numero）を指定して boleto を取得します。 |
get_account_balance | BTG+ 当座預金口座（conta corrente）の利用可能残高を取得します。 |
get_account_statement | 指定期間の口座明細の取引を取得します。 |
list_investment_positions | BTG で保有する取引先の投資ポジションを、債券資産クラス（CDB、LCI、L...）に絞って一覧表示します。 |
get_portfolio_summary | BTG で保有するすべての資産クラス（債券、ファンド、株式、国債...）を対象に、ポートフォリオの概要をまとめて取得します。 |
list_funds_available | BTG のプラットフォームで販売可能なファンドを一覧表示します。 |
subscribe_to_fund | BTG の販売プラットフォームでファンドを購入（aplicar）します。 |
redeem_from_fund | ファンドを解約（resgatar）します。 |
インストール
npm install @codespar/[email protected]
環境
BTG_CLIENT_ID="..." # OAuth client_id from BTG's Developer Portal
BTG_CLIENT_SECRET="..." # OAuth client_secret
BTG_CERT_PATH="/abs/path/to/client.crt" # mTLS client certificate
BTG_KEY_PATH="/abs/path/to/client.key" # mTLS private key
BTG_ENV="sandbox" # or "production" (default: sandbox)
認証
すべての呼び出しで、次の 2 つの要素が両方とも必要です。
- OAuth2
client_credentials— サーバーがトークンエンドポイントを呼び出し、有効期限の約 60 秒前までベアラートークンをキャッシュし、下流の呼び出しにAuthorization: Bearer <token>を付与します。 - mTLS — BACEN は Pix v2 で相互 TLS を義務付けており、BTG はすべての製品群（銀行業務と投資）でこれを適用しています。サーバーは、指定されたパスからクライアント証明書と秘密鍵を読み込み、Node
https.Agentを構築して、すべてのリクエストをこれ経由で送信します。
証明書と鍵のバンドルは、契約締結後に BTG Developer Portal から取得します。OAuth 認証情報とは別のものです。
実行
# stdio (default)
npx @codespar/mcp-btg
# HTTP transport
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-btg
注意事項
- パスは未検証です。
src/index.tsのTODO(verify)マーカーを参照してください。オンボーディング済みの取引先は、ポータルから発行された OpenAPI 仕様に照らして検証し、PR を作成してください。 - サンドボックスのホスト名は推定です。 BTG は取引先ごとにサンドボックスのサブドメインを発行します。割り当てられたサンドボックス URL が異なる場合は、
BASE_URLを編集して上書きしてください。 - **投資関連 API（CDB／LCI／LCA／社債／ファンド）**は、このリポジトリ内の個人向け銀行 MCP サーバーとの差別化要素ですが、OpenAPI 仕様をバイト単位で検証した後にフィールドの形式が変更される可能性があります。
エンタープライズ
エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。