Mcp Belvo

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

Belvo — Open Finance aggregator for LATAM

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向拉美开放金融聚合平台 Belvo 的本地 MCP 服务器，让助手列出机构、链接、账户、余额、交易等数据。

可以做什么
  • 列出可用的金融机构，并创建、查看、更新或删除指向机构的链接
  • 按链接获取账户、余额、交易、持有人、收入、投资、纳税申报、就业记录、发票和应收账款数据
  • 按可选条件浏览已存储的账户、交易、余额、持有人和收入记录
  • 为 Belvo Connect Widget 创建短期访问令牌
适用场景
适合需要助手通过 Belvo 获取拉美（墨西哥、阿根廷、哥伦比亚）银行与财税数据的场景，例如查看某个已链接机构的交易、余额或收入，或在沙箱环境中测试。
运行要求
以 stdio 方式在本地运行（npm 包，需要 Node.js 运行时）。需要从 Belvo 控制台获取的凭据，通过环境变量 BELVO_SECRET_ID 和 BELVO_SECRET_PASSWORD 提供，并需能访问 Belvo API。可将 BELVO_SANDBOX 设为 true 使用沙箱而非生产环境。
安装前请注意
需要真实的 Belvo 密钥凭据，可访问金融数据，请勿写入共享配置。未设置 BELVO_SANDBOX 时默认连接生产环境，工具会操作真实数据。部分工具会写入或删除数据：create_link、patch_link（更新凭据或在多因素认证后恢复）以及 delete_link（删除链接及其全部关联数据）。金融与个人数据会发送至 Belvo 的 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Belvo，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP Belvo

MCP server for Belvo — Open Finance aggregator for LATAM (Mexico, Argentina, Colombia).

Quick Start

bash
# Set your credentialsexport BELVO_SECRET_ID="your-secret-id"export BELVO_SECRET_PASSWORD="your-secret-password"export BELVO_SANDBOX=true  # Use sandbox environment
# Run via stdionpx tsx packages/mexico/belvo/src/index.ts
# Run via HTTPnpx tsx packages/mexico/belvo/src/index.ts --http

Environment Variables

VariableRequiredDescription
BELVO_SECRET_IDYesSecret ID from Belvo dashboard
BELVO_SECRET_PASSWORDYesSecret password from Belvo dashboard
BELVO_SANDBOXNoSet to "true" to use sandbox (default: production)
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (24)

ToolPurpose
list_institutionsList available financial institutions
create_linkCreate a link to a financial institution
list_linksList existing links
get_accountsGet accounts for a link
get_balancesGet balances for a link
get_transactionsGet transactions for a link
get_ownersGet owner information for a link
get_incomesGet income data for a link
get_tax_returnsGet tax returns for a link (fiscal institutions)
get_investmentsGet investment portfolios for a link
get_linkRetrieve details of a specific link by ID
delete_linkDelete a link (and all its associated data) by ID
patch_linkUpdate a link's credentials or resume after MFA (PATCH /api/links/)
list_accountsList stored accounts (GET /api/accounts/) with optional filters
get_account_detailRetrieve a stored account by account ID
list_transactionsList stored transactions (GET /api/transactions/) with optional filters
get_transaction_detailRetrieve a stored transaction by transaction ID
list_balancesList stored balances (GET /api/balances/) with optional filters
list_ownersList stored owners (GET /api/owners/)
list_incomesList stored incomes (GET /api/incomes/)
get_employment_recordsGet employment records for a link (employment institutions)
get_invoicesGet invoices for a link (BR/MX fiscal institutions)
get_receivables_transactionsGet receivables transactions for a link (payment rails / acquirer data)
create_widget_tokenCreate a short-lived access token for the Belvo Connect Widget

Auth

Uses Basic authentication (secret_id:secret_password). Obtain your credentials from the Belvo Dashboard.

API Reference

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

  • BELVO_SECRET_ID (required, secret) — Secret ID for Belvo
  • BELVO_SECRET_PASSWORD (required, secret) — Secret password for Belvo
  • BELVO_SANDBOX — Set to true to use sandbox environment

Issue credentials at the provider's developer portal: https://developers.belvo.com.

License

MIT

来源：packages/mexico/belvo/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分