MCP · Open Finance

Bank MCP

O Bank MCP é um servidor MCP pessoal e somente leitura. Ele entrega dados de Open Finance, agregados pela Pluggy, a clientes MCP como Claude Code, Codex e Antigravity CLI.

https://test-bank.kayran.dev/mcp

O que é

Cada token é emitido pelo operador e só alcança os perfis e as contas liberados para ele. Nenhuma ferramenta escreve, move dinheiro ou altera dados no banco.

Saldos e transações seguem o ritmo de atualização do agregador. Quando um saldo chega sem a leitura mais recente, a resposta avisa.

Ferramentas

bank_list_profilesSomente leitura
Lista os perfis bancários liberados para o seu token.
openfinance_list_connectionsSomente leitura
Lista as conexões bancárias de um perfil.
openfinance_list_accountsSomente leitura
Lista as contas de uma conexão bancária.
openfinance_list_transactionsSomente leitura
Lista as transações de uma conta num período de datas explícito.
openfinance_list_credit_card_billsSomente leitura
Lista as faturas de um cartão de crédito e, se pedido, deriva a fatura aberta.
openfinance_get_account_balanceSomente leitura
Mostra o saldo atual de contas da mesma conexão e avisa quando ele está degradado.
openfinance_get_credit_card_billSomente leitura
Detalha uma fatura de cartão com as transações e os lançamentos na borda do fechamento.
openfinance_get_item_statusSomente leitura
Mostra o estado de sincronização e os avisos de uma conexão bancária.
openfinance_get_accounts_detailSomente leitura
Detalha contas selecionadas da mesma conexão bancária.
openfinance_list_investmentsSomente leitura
Lista os investimentos de uma conexão bancária e avisa quando os dados estão incompletos.
openfinance_list_investment_transactionsSomente leitura
Lista as movimentações de um investimento da conexão bancária selecionada.
openfinance_list_loansSomente leitura
Lista os empréstimos de uma conexão bancária e avisa quando os dados estão incompletos.

Como configurar

Você precisa de um token. Ele é emitido pelo operador que compartilhou este link: peça a ele. Esta página não emite tokens.

Claude Code

Defina a variável de ambiente BANK_MCP_TOKEN com o seu token e adicione o servidor pelo comando ou pelo JSON abaixo.

JSON

{
  "mcpServers": {
    "personal-bank": {
      "type": "http",
      "url": "https://test-bank.kayran.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${BANK_MCP_TOKEN}"
      }
    }
  }
}

CLI

claude mcp add --transport http personal-bank https://test-bank.kayran.dev/mcp --header "Authorization: Bearer $BANK_MCP_TOKEN"

Codex

Defina a variável de ambiente BANK_MCP_TOKEN com o seu token e adicione o servidor pelo comando ou pelo trecho de ~/.codex/config.toml abaixo.

~/.codex/config.toml

[mcp_servers.personal-bank]
url = "https://test-bank.kayran.dev/mcp"
bearer_token_env_var = "BANK_MCP_TOKEN"

CLI

codex mcp add personal-bank --url https://test-bank.kayran.dev/mcp --bearer-token-env-var BANK_MCP_TOKEN

Antigravity CLI

Coloque o bloco abaixo em ~/.gemini/config/mcp_config.json, troque <token> pelo seu token e deixe o arquivo legível só por você (chmod 600). A leitura do token por variável de ambiente não foi validada neste cliente.

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "personal-bank": {
      "serverUrl": "https://test-bank.kayran.dev/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}