MCP Belvo (io.github.codespar/mcp-belvo)

MCP Belvo is a Model Context Protocol server that integrates Belvo as an Open Finance aggregator for LATAM, covering Mexico, Argentina, and Colombia. The project is associated with topics such as open finance and payments, including Pix and NFE.

🛠️ Key Features

MCP integration for Belvo (Open Finance aggregator for LATAM)
Targets Mexico, Argentina, and Colombia
Supports running via stdio or HTTP
Includes a Quick Start with required environment variables (secret ID, secret password, sandbox flag)

🚀 Use Cases

Connect agent tooling to Belvo for Open Finance data in LATAM
Use credentials configured for Belvo’s dashboard to access sandbox or non-sandbox environments
Enable payments-related workflows tied to Pix and NFE

⚡ Developer Benefits

Environment variables documented: BELVO_SECRET_ID, BELVO_SECRET_PASSWORD, BELVO_SANDBOX
Launch options documented for stdio and --http
Positioned for LLM tools and MCP-based agentic systems

⚠️ Limitations

Documentation excerpt provided includes Quick Start and variables only; specific tools, outputs, or capabilities are not shown in the provided data.

# 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

Variable

Required

Description

BELVO_SECRET_ID

Yes

Secret ID from Belvo dashboard

BELVO_SECRET_PASSWORD

Yes

Secret password from Belvo dashboard

BELVO_SANDBOX

Set to "true" to use sandbox (default: production)

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

HTTP port (default: 3000)

Tools (24)

Tool

Purpose

list_institutions

List available financial institutions

create_link

Create a link to a financial institution

list_links

List existing links

get_accounts

Get accounts for a link

get_balances

Get balances for a link

get_transactions

Get transactions for a link

get_owners

Get owner information for a link

get_incomes

Get income data for a link

get_tax_returns

Get tax returns for a link (fiscal institutions)

get_investments

Get investment portfolios for a link

get_link

Retrieve details of a specific link by ID

delete_link

Delete a link (and all its associated data) by ID

patch_link

Update a link's credentials or resume after MFA (PATCH /api/links/)

list_accounts

List stored accounts (GET /api/accounts/) with optional filters

get_account_detail

Retrieve a stored account by account ID

list_transactions

List stored transactions (GET /api/transactions/) with optional filters

get_transaction_detail

Retrieve a stored transaction by transaction ID

list_balances

List stored balances (GET /api/balances/) with optional filters

list_owners

List stored owners (GET /api/owners/)

list_incomes

List stored incomes (GET /api/incomes/)

get_employment_records

Get employment records for a link (employment institutions)

get_invoices

Get invoices for a link (BR/MX fiscal institutions)

get_receivables_transactions

Get receivables transactions for a link (payment rails / acquirer data)

create_widget_token

Create a short-lived access token for the Belvo Connect Widget

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.

Install

Configuration

Environment variables

BELVO_SECRET_IDrequiredsecret

Secret ID for Belvo

BELVO_SECRET_PASSWORDrequiredsecret

Secret password for Belvo

BELVO_SANDBOX

Set to true to use sandbox environment

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-belvo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-belvo@0.2.2"
      ],
      "env": {
        "BELVO_SECRET_ID": "<YOUR_BELVO_SECRET_ID>",
        "BELVO_SECRET_PASSWORD": "<YOUR_BELVO_SECRET_PASSWORD>",
        "BELVO_SANDBOX": "<YOUR_BELVO_SANDBOX>"
      }
    }
  }
}

io.github.codespar/mcp-belvo

MCP Belvo (io.github.codespar/mcp-belvo)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

MCP Belvo

Quick Start

Environment Variables

Tools (24)

Auth

API Reference

Enterprise

Authentication

License

Install

Configuration

Related servers