Mcp Belvo

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Belvo — Open Finance aggregator for LATAM

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Belvo, a Latin American open-finance aggregator, letting an assistant list institutions, links, accounts, balances, transactions and more.

What you can do
  • List financial institutions and create, inspect, update or delete links to them
  • Retrieve accounts, balances, transactions, owners, incomes, investments, tax returns, employment records, invoices and receivables for a link
  • Browse stored records such as accounts, transactions, balances, owners and incomes with optional filters
  • Create a short-lived token for the Belvo Connect Widget
When to use it
Useful when you want an assistant to pull LATAM banking and fiscal data (Mexico, Argentina, Colombia) through Belvo, for example to review transactions, balances or income for a linked institution, or to work in the sandbox while testing.
Requirements
Runs locally over stdio (npm package, Node.js runtime). Requires Belvo credentials in BELVO_SECRET_ID and BELVO_SECRET_PASSWORD, obtained from the Belvo dashboard, plus network access to the Belvo API. BELVO_SANDBOX can be set to true to use the sandbox instead of production.
Before you install
Requires real Belvo secret credentials, which grant access to financial data; keep them out of shared configs. Defaults to production unless BELVO_SANDBOX is set, so tools act on live data. Some tools write or destroy data: create_link, patch_link (updates credentials or resumes after MFA) and delete_link, which removes a link and all its associated data. Financial and personal data is sent to Belvo's API.

Installation

In SourceWeft

  1. Open Mcp Belvo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/mexico/belvo/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts