openfinance_list_connectionsLABSCO SUMMARY
Read-only by design, and the card-bill logic is the part that does real work.
Open Finance does not report whether a card bill was paid, so the server derives a payment status by matching payments across billing cycles — the kind of thing you would otherwise get wrong by hand. Nothing here moves money: the only writes are forcing a sync and revoking a bank's consent, which is also how you take the access back.
What it is
A hosted Open Finance server for Brazil. Once you have connected banks through the regulated consent flow, it exposes accounts, transactions, credit card bills, investments and loans as read-only tools an assistant can query.
What you get
- openfinance_list_connections and openfinance_get_item_status — which banks are connected and whether each one is syncing
- openfinance_list_accounts and openfinance_get_accounts_detail — current accounts, savings and cards, with limits and additional cards
- openfinance_get_account_balance — real-time balances for up to fifty accounts at once
- openfinance_list_transactions — statements filtered by date range and keyword; for credit cards this is the only way to get itemised entries, each linked back to its bill
- openfinance_list_credit_card_bills and openfinance_get_credit_card_bill — card bills, with a payment status derived by matching payments across billing cycles
- openfinance_list_investments and openfinance_list_investment_transactions — the portfolio across equities, ETFs, fixed income, funds and pensions, with itemised fees and taxes on each movement
- openfinance_list_loans — loan contracts per connection
- openfinance_list_categories — the transaction category taxonomy
- openfinance_force_sync — ask the aggregator to refresh a connection now
- openfinance_disconnect_bank — revoke the Open Finance consent for a bank and delete the connection
Requirements
An account on the service, created by magic link on first use, and at least one bank connected through the Open Finance consent flow. The server is remote at the published Streamable HTTP endpoint, so any client that speaks MCP over HTTP can use it — Claude, Cursor and VS Code all have a one-click install link. Nothing to install locally.
Setup effort
Follow the published steps — Create an account: go to app.mcp.ai/banco, enter your e-mail, click the magic-link (no password)
USE CASES
01
Working out where the money went
Pull the statement for the period, filtered by keywords, and group it by category.
02
Understanding a card bill
List the bills with their derived payment status, then pull the itemised entries linked to the one you are querying.
03
Seeing everything at once
List the connected banks and their accounts, then read the real-time balances together.
04
Reviewing the portfolio
List investments by type and read the movements and fees behind one of them.
05
Fixing stale data
Check the connection's sync status and force a refresh when the numbers look old.
06
Taking the access back
Revoke the Open Finance consent for a bank and remove the connection.
14 tools
Listed in project docs. Your client may show a different list.
openfinance_get_item_statusopenfinance_list_accountsopenfinance_get_accounts_detailopenfinance_get_account_balanceopenfinance_list_transactionsopenfinance_list_credit_card_billsopenfinance_get_credit_card_billopenfinance_list_investmentsopenfinance_list_investment_transactionsopenfinance_list_loansopenfinance_list_categoriesopenfinance_force_syncopenfinance_disconnect_bankBEFORE YOU INSTALL
What to know first
Tools you get
14 tools named in the project's documentation. A 15th tool, authenticate, appears only for clients that cannot do OAuth. No tool moves money, but openfinance_force_sync and openfinance_disconnect_bank change state.
Where it runs
All 6 documented clients connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
Setup
Create an account: go to app.mcp.ai/banco, enter your e-mail, click the magic-link (no password)
Connect your banks: Conectar banco → pick the bank → authenticate in the bank's app/internet banking → grant the read-only, revocable Open Finance consent
Configure your MCP client with the single remote URL https://api.mcp.ai/banco — url only, no headers and no key; the same entry works whether your client signs in over OAuth or not (each tab below shows it in that client's own format)
Claude web or desktop: open claude.ai/customize/connectors, click + and add a custom connector with the name Banco MCP and the URL https://api.mcp.ai/banco (the link in the Claude.ai tab opens this form already filled in)
Cursor and VS Code one-click install links: cursor://anysphere.cursor-deeplink/mcp/install?name=banco&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvYmFuY28ifQ== (Cursor) and vscode:mcp/install?name=banco&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fbanco%22%7D (VS Code)
Auth happens at runtime on the first call: modern clients do OAuth 2.1 via browser magic-link; clients without OAuth get an authenticate tool and you paste a JWT from https://app.mcp.ai/agent-auth
Optional, separate from the server: install the companion agent skill with npx skills add douglac/banco-mcp (add -g for global, -a claude-code for a specific agent), or manually with cp -r skills/banco-mcp ~/.claude/skills/
Hosted endpoint
ENDPOINT URL
https://api.mcp.ai/bancoAdd this hosted endpoint to your MCP client.
MCP Clients
Claude.ai, Claude Desktop
URL
https://claude.ai/customize/connectors?modal=add-custom-connector&mcpName=Banco%20MCP&mcpServerUrl=https%3A%2F%2Fapi.mcp.ai%2FbancoCursor, Manus, Other MCP clients
JSON
{
"mcpServers": {
"banco": {
"url": "https://api.mcp.ai/banco"
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"banco": {
"type": "http",
"url": "https://api.mcp.ai/banco"
}
}
}
