Language: English (UK)

MCP · Open Finance

Bank MCP

Bank MCP is a personal, read-only MCP server. It delivers Open Finance data, aggregated through Pluggy, to MCP clients such as Claude Code, Codex and Antigravity CLI.

https://bank.kayran.dev/mcp

What it is

Each token is issued by the operator and reaches only the profiles and accounts authorised for it. No tool writes, moves money or changes data at the bank.

Balances and transactions follow the aggregator's refresh schedule. When a balance arrives without the latest reading, the response says so.

Tools

  1. bank_list_profilesRead-only

    Lists the bank profiles authorised for your token.

  2. openfinance_list_connectionsRead-only

    Lists the bank connections in one profile.

  3. openfinance_list_accountsRead-only

    Lists the accounts of one bank connection.

  4. openfinance_list_transactionsRead-only

    Lists the transactions of one account over an explicit date period.

  5. openfinance_list_credit_card_billsRead-only

    Lists the bills of one credit card and, on request, derives the open bill.

  6. openfinance_get_account_balanceRead-only

    Shows the current balance of accounts in the same connection and flags when it is degraded.

  7. openfinance_get_credit_card_billRead-only

    Details one card bill with its transactions and the entries at the closing edge.

  8. openfinance_get_item_statusRead-only

    Shows synchronisation status and safe diagnostics for one bank connection.

  9. openfinance_get_accounts_detailRead-only

    Shows details of selected accounts in the same bank connection.

  10. openfinance_list_investmentsRead-only

    Lists investments in one bank connection and flags incomplete data.

  11. openfinance_list_investment_transactionsRead-only

    Lists movements of an investment in the selected bank connection.

  12. openfinance_list_loansRead-only

    Lists loans in one bank connection and flags incomplete data.

How to set it up

You need a token. It is issued by the operator who shared this link, so ask them. This page does not issue tokens.

Claude Code

Set the BANK_MCP_TOKEN environment variable to your token and add the server with the command or the JSON below.

JSON
{
  "mcpServers": {
    "personal-bank": {
      "type": "http",
      "url": "https://bank.kayran.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${BANK_MCP_TOKEN}"
      }
    }
  }
}
CLI
claude mcp add --transport http personal-bank https://bank.kayran.dev/mcp --header "Authorization: Bearer $BANK_MCP_TOKEN"

Codex

Set the BANK_MCP_TOKEN environment variable to your token and add the server with the command or the ~/.codex/config.toml snippet below.

~/.codex/config.toml
[mcp_servers.personal-bank]
url = "https://bank.kayran.dev/mcp"
bearer_token_env_var = "BANK_MCP_TOKEN"
CLI
codex mcp add personal-bank --url https://bank.kayran.dev/mcp --bearer-token-env-var BANK_MCP_TOKEN

Antigravity CLI

Put the block below in ~/.gemini/config/mcp_config.json, replace <token> with your token and make the file readable only by you (chmod 600). Reading the token from an environment variable has not been validated for this client.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "personal-bank": {
      "serverUrl": "https://bank.kayran.dev/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}