mcp-belvo

MCP Belvo

Belvo 用の MCP サーバー — LATAM（メキシコ、アルゼンチン、コロンビア）向けのオープンファイナンスアグリゲーターです。

クイックスタート

# Set your credentials
export BELVO_SECRET_ID="your-secret-id"
export BELVO_SECRET_PASSWORD="your-secret-password"
export BELVO_SANDBOX=true  # Use sandbox environment

# Run via stdio
npx tsx packages/mexico/belvo/src/index.ts

# Run via HTTP
npx tsx packages/mexico/belvo/src/index.ts --http

環境変数

変数	必須	説明
BELVO_SECRET_ID	はい	Belvo ダッシュボードで発行されたシークレット ID
BELVO_SECRET_PASSWORD	はい	Belvo ダッシュボードで発行されたシークレットパスワード
BELVO_SANDBOX	いいえ	サンドボックスを使用するには"true"に設定します（デフォルト：本番環境）
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには"true"に設定します
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（24）

ツール	目的
list_institutions	利用可能な金融機関を一覧表示します
create_link	金融機関へのリンクを作成します
list_links	既存のリンクを一覧表示します
get_accounts	リンクの口座を取得します
get_balances	リンクの残高を取得します
get_transactions	リンクの取引を取得します
get_owners	リンクの所有者情報を取得します
get_incomes	リンクの収入データを取得します
get_tax_returns	リンクの税務申告データを取得します（税務機関）
get_investments	リンクの投資ポートフォリオを取得します
get_link	ID を指定して特定のリンクの詳細を取得します
delete_link	ID を指定してリンクを削除します（関連するデータもすべて削除されます）
patch_link	リンクの認証情報を更新するか、MFA 後に再開します（PATCH /api/links/）
list_accounts	保存された口座を一覧表示します（GET /api/accounts/）。任意のフィルターを指定できます
get_account_detail	口座 ID を指定して保存された口座を取得します
list_transactions	保存された取引を一覧表示します（GET /api/transactions/）。任意のフィルターを指定できます
get_transaction_detail	取引 ID を指定して保存された取引を取得します
list_balances	保存された残高を一覧表示します（GET /api/balances/）。任意のフィルターを指定できます
list_owners	保存された所有者を一覧表示します（GET /api/owners/）
list_incomes	保存された収入を一覧表示します（GET /api/incomes/）
get_employment_records	リンクの雇用記録を取得します（雇用機関）
get_invoices	リンクの請求書を取得します（ブラジル／メキシコの税務機関）
get_receivables_transactions	リンクの売掛金取引を取得します（決済ネットワーク／アクワイアラーのデータ）
create_widget_token	Belvo Connect Widget 用の有効期間が短いアクセストークンを作成します

認証

Basic 認証（secret_id:secret_password）を使用します。認証情報はBelvo ダッシュボードから取得してください。

API リファレンス

• Belvo API ドキュメント

---

エンタープライズ

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

認証

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

• BELVO_SECRET_ID (必須、シークレット) — Belvo のシークレット ID
• BELVO_SECRET_PASSWORD (必須、シークレット) — Belvo のシークレットパスワード
• BELVO_SANDBOX — サンドボックス環境を使用するには true に設定します

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

ライセンス

MIT