English Français العربية

Banco Mercantil MCP

Registre officiel Finance et paiements

Connect your Banco Mercantil account to AI via Brazil's Open Finance: balances, statements, cards, i

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http banco-mercantil-mcp 'https://api.mcp.ai/p_mercantil'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "banco-mercantil-mcp": {
            "type": "http",
            "url": "https://api.mcp.ai/p_mercantil"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Banco Mercantil MCP
  2. Instalar em 1 clique
  3. Exemplos de uso
  4. 18 ferramentas disponíveis
  5. Preços
  6. Privacidade & LGPD
  7. Perguntas frequentes
  8. Suporte
  9. Licença

Banco Mercantil MCP

Banco Mercantil no Claude, ChatGPT e agentes de IA via Open Finance

Conecte sua conta do Banco Mercantil ao Claude, ChatGPT e agentes de IA via Open Finance Brasil. Pergunte sobre saldos, extratos, faturas de cartão e investimentos do Banco Mercantil em linguagem natural. Regulado pelo Banco Central, somente leitura.

  • 🏦 Banco Mercantil via Open Finance Brasil, regulado pelo Banco Central
  • 💳 Saldos, extratos, faturas de cartão, investimentos e empréstimos
  • 🔒 Somente leitura — a IA não movimenta dinheiro
  • 🔑 Login por magic-link, consentimento explícito e revogável (LGPD)
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Banco Mercantil MCP e URL https://api.mcp.ai/p_mercantil.

Cursor

➕ Instalar Banco Mercantil MCP no Cursor

VS Code (Copilot Chat)

➕ Instalar Banco Mercantil MCP no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_mercantil

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Quanto gastei no cartão do Banco Mercantil esse mês?
Resuma minha fatura do Banco Mercantil em aberto
Qual meu saldo na conta do Banco Mercantil?
Como está minha carteira de investimentos no Banco Mercantil?

18 ferramentas disponíveis

ToolDescrição
openfinance_search_bank_connectorsSearches the available bank connectors by name (pass keywords[], e.g.
openfinance_list_connectionsReturns the saved bank connections for this install: connector_id, item_id, bank name, and an add_connection_url to link additional banks via the Open Finance widget.
openfinance_get_item_statusReturns the current status of a bank connection (UPDATED, UPDATING, LOGIN_ERROR, etc.), its executionStatus, and connector metadata.
openfinance_provider_statusChecks the LIVE operational status of the Open Finance provider (its public status page) — this is the PROVIDER's health, separate from your own connection's openfinance_get_item_status.
openfinance_list_accountsReturns accounts for a bank connection: BANK (checking/savings) and CREDIT (credit card) with balance, number, type, subtype, bankData, and creditData.
openfinance_list_transactionsReturns transactions for a bank account (BANK or CREDIT type).
openfinance_list_transactions_by_itemConsolidated cash-flow analysis for a whole bank CONNECTION over a period, in ONE call.
openfinance_list_credit_card_billsReturns CLOSED credit card bills for a CREDIT-type account: dueDate, totalAmount, minimumPaymentAmount, allowsInstallments, plus payments[] (id, paymentDate, amount, valueType, paymentMode), payments_count, `payme…
openfinance_list_investmentsReturns the investment portfolio for a connection (broker or bank with INVESTMENTS product enabled): FIIs, stocks, ETFs, fixed income (CDB/LCI/LCA/Tesouro), mutual funds, retirement (previdência) and COE.
openfinance_list_investment_transactionsReturns the movement history for a specific investment position: BUY / SELL / TAX / INTEREST / AMORTIZATION / TRANSFER.
openfinance_list_loansLists loan contracts per bank connection (GET /loans).
openfinance_force_syncForces the bank to re-sync one or more connections NOW and WAITS for it to finish (PATCH /items/:id, then polls until the item stops updating, up to ~60s).
openfinance_get_account_balanceReturns real-time balance payload per account id (GET /accounts/:id/balance).
openfinance_get_accounts_detailReturns full account objects including extended creditData (additional cards, limits) per id (GET /accounts/:id).
openfinance_get_credit_card_billReturns bill-level detail for one or more credit card bills by id (GET /bills/:id): financeCharges and payments[] (id, paymentDate, amount, valueType, paymentMode).
openfinance_list_categoriesReturns the provider's transaction category taxonomy (GET /categories), cached for the adapter session.
openfinance_update_transaction_categoryCorrects the category of one or more transactions (PATCH /transactions/:id).
openfinance_disconnect_bankRevokes the Open Finance consent for a specific bank and deletes the connection data.

Detalhe de cada tool: docs/ferramentas.md

Preços

Veja docs/precos.md.

Privacidade & LGPD

  • Somente leitura, nenhuma ferramenta altera dados na origem.
  • Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

Como funciona? Via Open Finance Brasil (regulado pelo Banco Central). Você conecta sua conta Banco Mercantil com consentimento explícito; a IA lê saldos, extratos, faturas e investimentos. Somente leitura.

A IA pode movimentar dinheiro? Não. 100% leitura — Open Finance não permite movimentação por essa via.

Só funciona com o Banco Mercantil? Este MCP é focado no Banco Mercantil. Para conectar vários bancos de uma vez, use o Banco MCP (api.mcp.ai/banco).

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills, tudo MIT.

Suporte

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_mercantil é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Questions fréquentes

Qu'est-ce que Banco Mercantil MCP ?

Connect your Banco Mercantil account to AI via Brazil's Open Finance: balances, statements, cards, i

Comment installer Banco Mercantil MCP ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http banco-mercantil-mcp 'https://api.mcp.ai/p_mercantil'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Banco Mercantil MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Banco Mercantil MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Banco Mercantil MCP ?

Il est publié par mcp-dir. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.