Skip to content
Back to search

mercantil-mcp

Unofficial, not affiliated with Banco Mercantil. Read-only Open Finance MCP by MCP.AI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mcp-dir--mercantil-mcp/badge.svg)](/listings/mcp-dir--mercantil-mcp)

HTML

<a href="/listings/mcp-dir--mercantil-mcp"><img src="/api/listings/mcp-dir--mercantil-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 132 lines
  1. # Conector MCP.AI para Banco Mercantil
  2. ### Use seus dados do Banco Mercantil no Claude, ChatGPT e agentes de IA via Open Finance
  3. > ⚠️ A MCP.AI não é afiliada, patrocinada nem endossada pelo Banco Mercantil. Banco Mercantil é marca registrada de seu titular e é citada apenas para indicar com qual instituição este conector funciona. O acesso aos dados acontece pelo Open Finance Brasil, regulado pelo Banco Central, com autorização do próprio cliente.
  4. 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.
  5. - 🏦 **Banco Mercantil via Open Finance Brasil**, regulado pelo Banco Central
  6. - 💳 **Saldos, extratos, faturas de cartão, investimentos e empréstimos**
  7. - 🔒 **Somente leitura** — a IA não movimenta dinheiro
  8. - 🔑 **Login por magic-link**, consentimento explícito e revogável (LGPD)
  9. - 💬 **Funciona com qualquer cliente MCP**: Claude Desktop, Cursor, VS Code, Cline, Continue
  10. [English version](README.en.md) · [Documentação completa](docs/) · [Skill pra agentes](skills/)
  11. ---
  12. ## Instalar em 1 clique
  13. ### Claude (Web e Desktop)
  14. 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):
  15. [➕ Abrir no Claude e conectar](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors)
  16. **Manual** (se o deeplink não abrir): [claude.ai/customize/connectors](https://claude.ai/customize/connectors?surface=cowork) → **+** → **Adicionar conector personalizado** → cole **Nome** `Conector MCP.AI para Banco Mercantil` e **URL** `https://api.mcp.ai/p_mercantil`.
  17. ### Cursor
  18. [➕ Instalar Conector MCP.AI para Banco Mercantil no Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=mercantil&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9tZXJjYW50aWwifQ==)
  19. ### VS Code (Copilot Chat)
  20. [➕ Instalar Conector MCP.AI para Banco Mercantil no VS Code](vscode:mcp/install?name=mercantil&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_mercantil%22%7D)
  21. ### ChatGPT, Manus, OpenClaw e mais 40+ clientes
  22. Funciona em qualquer cliente MCP que suporte **MCP over HTTP**. A URL do servidor é sempre:
  23. ```
  24. https://api.mcp.ai/p_mercantil
  25. ```
  26. Detalhes por cliente: [INSTALL.md](INSTALL.md).
  27. ---
  28. ## Exemplos de uso
  29. ```
  30. Quanto gastei no cartão do Banco Mercantil esse mês?
  31. Resuma minha fatura do Banco Mercantil em aberto
  32. Qual meu saldo na conta do Banco Mercantil?
  33. Como está minha carteira de investimentos no Banco Mercantil?
  34. ```
  35. ---
  36. ## 19 ferramentas disponíveis
  37. | Tool | Descrição |
  38. |---|---|
  39. | `openfinance_search_bank_connectors` | Searches the available bank connectors by name (pass keywords[], e.g. |
  40. | `openfinance_list_connections` | Returns the saved bank connections for this install: connector_id, item_id, bank name, a per-connection reconnect_url, and an add_connection_url to link additional banks via the Open Finance widget. |
  41. | `openfinance_get_item_status` | Returns the current status of a bank connection (UPDATED, UPDATING, LOGIN_ERROR, etc.), its executionStatus, connector metadata, and a reconnect_url that reopens the widget in UPDATE mode for that connection (re-authe… |
  42. | `openfinance_provider_status` | Checks 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`. |
  43. | `openfinance_list_accounts` | Returns accounts for a bank connection: BANK (checking/savings) and CREDIT (credit card) with balance, number, type, subtype, bankData, and creditData. |
  44. | `openfinance_list_transactions` | Returns transactions for a bank account (BANK or CREDIT type). |
  45. | `openfinance_list_transactions_by_item` | Consolidated cash-flow analysis for a whole bank CONNECTION over a period, in ONE call. |
  46. | `openfinance_list_credit_card_bills` | Returns CLOSED credit card bills for a CREDIT-type account: dueDate, totalAmount, minimumPaymentAmount, allowsInstallments, plus `payments[]` (id, paymentDate, amount, valueType, paymentMode), `payments_count`, `payme… |
  47. | `openfinance_list_investments` | Returns 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. |
  48. | `openfinance_list_investment_transactions` | Returns the movement history for a specific investment position: BUY / SELL / TAX / INTEREST / AMORTIZATION / TRANSFER. |
  49. | `openfinance_list_loans` | Lists loan contracts per bank connection (GET /loans). |
  50. | `openfinance_get_loan_detail` | Returns full loan contract detail by id (GET /loans/:loanId): interestRates[] (taxType, ratePercentage, indexer), contractedFinanceCharges[], balloonPayments[], warranties[], installments schedule (installmentsCount,… |
  51. | `openfinance_force_sync` | Forces 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). |
  52. | `openfinance_get_account_balance` | Returns the latest available balance per account id (GET /accounts/:id/balance). |
  53. | `openfinance_get_accounts_detail` | Returns full account objects including extended creditData (additional cards, limits) per id (GET /accounts/:id). |
  54. | `openfinance_get_credit_card_bill` | Returns bill-level detail for one or more credit card bills by id (GET /bills/:id): `dueDate`, `billClosingDate` (when the cycle closed — the boundary that defines which purchases belong to this bill), `totalAmount`,… |
  55. | `openfinance_list_categories` | Returns the provider's transaction category taxonomy (GET /categories), cached for the adapter session. |
  56. | `openfinance_update_transaction_category` | Corrects the category of one or more transactions (PATCH /transactions/:id). |
  57. | `openfinance_disconnect_bank` | Revokes the Open Finance consent for a specific bank and deletes the connection data. |
  58. Detalhe de cada tool: [docs/ferramentas.md](docs/ferramentas.md)
  59. ---
  60. ## Preços
  61. Veja [docs/precos.md](docs/precos.md).
  62. ---
  63. ## Privacidade & LGPD
  64. - **Somente leitura**, nenhuma ferramenta altera dados na origem.
  65. - **Sub-processadores**: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em [docs/privacidade-lgpd.md](docs/privacidade-lgpd.md).
  66. - 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.
  67. ---
  68. ## Perguntas frequentes
  69. **A MCP.AI é afiliada ao Banco Mercantil?**
  70. A MCP.AI não é afiliada, patrocinada nem endossada pelo Banco Mercantil. Banco Mercantil é marca registrada de seu titular e é citada apenas para indicar com qual instituição este conector funciona. O acesso aos dados acontece pelo Open Finance Brasil, regulado pelo Banco Central, com autorização do próprio cliente.
  71. **Como funciona?**
  72. 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.
  73. **A IA pode movimentar dinheiro?**
  74. Não. 100% leitura — Open Finance não permite movimentação por essa via.
  75. **Só funciona com o Banco Mercantil?**
  76. Este MCP é focado no Banco Mercantil. Para conectar vários bancos de uma vez, use o Banco MCP (api.mcp.ai/banco).
  77. **O servidor é open source?**
  78. O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills, tudo MIT.
  79. ---
  80. ## Suporte
  81. - 📧 [mercantil@mcp.ai](mailto:mercantil@mcp.ai)
  82. - 🐛 [GitHub Issues](https://github.com/mcp-dir/mercantil-mcp/issues)
  83. - 📄 [docs/](docs/)
  84. ---
  85. ## Licença
  86. MIT — veja [LICENSE](LICENSE). O servidor MCP em `api.mcp.ai/p_mercantil` é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.