Skip to main content
Glama
mottibec

Israeli Bank MCP

by mottibec

Israeli Bank MCP

A project for managing Israeli bank accounts and transactions using the Model Context Protocol (MCP).

Features

  • List available Israeli banks and credit card companies with their required credentials

  • Fetch transactions from any supported bank

  • Support for all major Israeli banks and credit card companies

  • Secure credential handling

  • Flexible transaction date ranges

  • Two-factor authentication support

Related MCP server: MoneyWiz MCP Server

Getting Started

  1. Install dependencies:

npm install
  1. Build the project:

npm run build
  1. Connect to MCP Clients

Connecting to MCP Clients

The server can be connected to any MCP-compatible client. Here's how to configure it:

Example Configuration

Credentials are read from environment variables (never from tool arguments — this avoids leaking them into the LLM conversation history). Each bank requires <BANK_ID>_<FIELD> env vars. For example, Bank Leumi needs LEUMI_USERNAME and LEUMI_PASSWORD; Hapoalim needs HAPOALIM_USERCODE and HAPOALIM_PASSWORD. Use the banks://list resource to see required env-var names per bank.

For clients that support configuration files (like Claude), add the following to your configuration:

{
    "mcpServers": {
        "israeli-bank-mcp": {
            "command": "node",
            "args": [
                "/path/to/israeli-bank-mcp/build/server.js"
            ],
            "env": {
                "LEUMI_USERNAME": "your-username",
                "LEUMI_PASSWORD": "your-password"
            }
        }
    }
}

Resources

  • Banks (banks://list)

    • List available banks and their required credentials

Tools

  • Fetch transactions (fetch-transactions)

    • Fetch transactions from a bank

  • 2FA (two-factor-auth)

    • 2FA authentication for banks that require that

Supported Banks

The server supports all major Israeli banks and credit card companies through the israeli-bank-scrapers library:

  • Bank Hapoalim

  • Leumi Bank

  • Discount Bank

  • Mercantile Bank

  • Mizrahi Bank

  • Otsar Hahayal Bank

  • Visa Cal

  • Max (Formerly Leumi Card)

  • Isracard

  • Amex

  • Union Bank

  • Beinleumi

  • Massad

  • Yahav

  • Beyhad Bishvilha

  • OneZero (Experimental)

  • Behatsdaa

Security

  • Please do not attempt this at home (I honestly don't know, it's probably not a good idea, but it's really cool)

License

MIT

Available Tools

2 tools
fetch-transactionsD
ParametersJSON Schema
NameRequiredDescriptionDefault
bankIdYes
combineInstallmentsNo
credentialsYes
showBrowserNo
startDateNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

two-factor-authD
ParametersJSON Schema
NameRequiredDescriptionDefault
actionYes
bankIdYes
otpCodeNo
phoneNumberYes

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • First observedfetch-transactions
    • First observedtwo-factor-auth

TDQS

D1.6/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: 'fetch-transactions' retrieves transaction data, while 'two-factor-auth' handles authentication. There is no overlap or ambiguity between these functions, making it easy for an agent to select the correct tool.

Naming Consistency4/5

Both tools use a consistent verb-noun pattern with hyphens (e.g., 'fetch-transactions', 'two-factor-auth'), which is predictable and readable. The minor deviation is that 'two-factor-auth' uses a compound noun without a clear verb, but overall the naming is coherent.

Tool Count2/5

With only two tools, the server feels thin for a banking domain, which typically requires operations like account management, transfers, balances, or payments. This limited set may not cover essential banking workflows, indicating an under-scoped tool surface.

Completeness1/5

The tool set is severely incomplete for a banking server. It lacks basic operations such as checking account balances, initiating transfers, managing accounts, or handling payments. The two tools provided do not form a functional banking interface, leading to significant gaps that will cause agent failures.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that allows AI assistants to interact with Lunch Money accounts, enabling management of transactions, categories, budgets, and other financial data through natural language commands.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that provides AI assistants like Claude with secure, read-only access to MoneyWiz financial data for natural language queries and financial analytics.
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for the Pluggy Open Finance Brazil API, enabling connection to bank accounts and management of financial data including transactions, accounts, investments, and payment intents through natural language.
    10 npm
    MIT
  • A
    license
    B
    quality
    F
    maintenance
    A Model Context Protocol server that provides programmatic access to Firefly III personal finance management. It enables AI assistants to manage accounts, transactions, budgets, and more through natural language.
    5
    8
    AGPL 3.0