MCP Belvo

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

Quick Start

# 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

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BELVO_SECRET_ID | Yes | Secret ID from Belvo dashboard | | BELVO_SECRET_PASSWORD | Yes | Secret password from Belvo dashboard | | BELVO_SANDBOX | No | Set to "true" to use sandbox (default: production) | | MCP_HTTP | No | Set to "true" to enable HTTP transport | | MCP_PORT | No | 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 |

Auth

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

API Reference

• Belvo API Docs

Enterprise? Contact us at codespar.com for dedicated support, custom integrations, and SLAs.