# Banco Mercantil MCP

Connects Banco Mercantil to an AI agent through Open Finance Brasil, so you can ask about accounts, spending, cards, investments, and loans.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 339 installs
- Author: mcp-dir
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcp-dir/mercantil-mcp
- Updated: 2026-08-30
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/banco-mercantil-mcp

## What it does

Banco Mercantil MCP gives an MCP client read access to Banco Mercantil data through Open Finance Brasil. It can return account balances, transactions, closed card bills, investment holdings and their movements, plus loan details. You interact with these records in natural language.

The server includes tools for linking a bank, checking connection state, forcing a sync, reading account details, and changing transaction categories. Sign-in uses a magic link and explicit consent that can be revoked. It is read-only, so the agent cannot move money or edit bank records.

You need an MCP client and access to the hosted server. Data returned by the tools is sent to the LLM host you choose, such as Claude, ChatGPT, Cursor, or your own agent. That data flow matters when you set privacy controls.

## Requirements
- Remote server: `https://mercantil-mcp--mcp-dir.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mercantil-mcp https://mercantil-mcp--mcp-dir.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add banco-mercantil-mcp --url https://mercantil-mcp--mcp-dir.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "banco-mercantil-mcp": {
            "url": "https://mercantil-mcp--mcp-dir.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "banco-mercantil-mcp": {
            "type": "http",
            "url": "https://mercantil-mcp--mcp-dir.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http banco-mercantil-mcp https://mercantil-mcp--mcp-dir.run.tools
```

## When to use it
- check a Banco Mercantil account balance
- review transactions for a chosen period
- summarize an open credit card bill
- inspect an investment portfolio
- check the state of a bank connection

## Example prompts
- Show my current Banco Mercantil account balance.
- Group this month’s Banco Mercantil transactions by category.
- Review my Banco Mercantil investment holdings and recent position movements.

## Similar
- [Banco MCP](https://affpapa.org/en/nevibecode/mcp/banco-mcp.md) — MCP server · ★ 27 repo stars
- [Unicred MCP](https://affpapa.org/en/nevibecode/mcp/unicred-mcp.md) — MCP server · 389 installs
- [Fillfolio MCP](https://affpapa.org/en/nevibecode/mcp/fillfolio-mcp.md) — MCP server
- [bankbridge](https://affpapa.org/en/nevibecode/plugins/bankbridge.md) — plugin · ★ 1596 repo stars
- [mcp-open-finance](https://affpapa.org/en/nevibecode/mcp/mcp-open-finance.md) — MCP server · ★ 279 repo stars

---
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
