# mcp-belvo

MCP server interfacing with Belvo Open Finance in Latin America. Enables your AI assistant to retrieve bank transactions, account balances, and tax records during coding sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/mexico/belvo
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-belvo

## What it does

This server bridges AI agents with the Belvo API across Mexico, Argentina, and Colombia. It provides 24 tools dedicated to managing financial data links. The model can discover supported institutions, initialize institution credentials, and resume authentication flows when multi-factor challenges occur.

Available tools pull stored account details, balance figures, transaction ledgers, and verified income reports. The server can also query employment records, official tax filings, and payment acquirer logs where regional providers support them.

Communication runs over stdio or HTTP on port 3000. Missing `BELVO_SECRET_ID` or `BELVO_SECRET_PASSWORD` values will halt all incoming tool calls immediately. Production mode runs by default, so tests must explicitly pass `BELVO_SANDBOX="true"`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BELVO_SECRET_ID`, `BELVO_SECRET_PASSWORD`, `BELVO_SANDBOX` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BELVO_SECRET_ID=<BELVO_SECRET_ID> --env BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> --env BELVO_SANDBOX=<BELVO_SANDBOX> --transport stdio belvo -- npx -y @codespar/mcp-belvo
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add belvo --env BELVO_SECRET_ID=<BELVO_SECRET_ID> --env BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> --env BELVO_SANDBOX=<BELVO_SANDBOX> -- npx -y @codespar/mcp-belvo
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "belvo": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-belvo"
            ],
            "env": {
                "BELVO_SECRET_ID": "<BELVO_SECRET_ID>",
                "BELVO_SECRET_PASSWORD": "<BELVO_SECRET_PASSWORD>",
                "BELVO_SANDBOX": "<BELVO_SANDBOX>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "belvo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-belvo"
            ],
            "env": {
                "BELVO_SECRET_ID": "<BELVO_SECRET_ID>",
                "BELVO_SECRET_PASSWORD": "<BELVO_SECRET_PASSWORD>",
                "BELVO_SANDBOX": "<BELVO_SANDBOX>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BELVO_SECRET_ID=<BELVO_SECRET_ID> -e BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> -e BELVO_SANDBOX=<BELVO_SANDBOX> belvo npx -y @codespar/mcp-belvo
```
Replace <…> with your own values

## When to use it
- retrieve balances and transaction ledgers from LATAM banking institutions
- verify customer income records and official employment data
- inspect fiscal tax declarations and digital invoices
- issue short-lived access tokens for the Belvo Connect widget

## Example prompts
- Call `list_institutions` to inspect supported banks in the region.
- Fetch recent account entries using `get_transactions` for the active link id.
- Run `create_widget_token` to initialize a session token for the client widget.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md