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

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