Israeli Bank Connector

Instructions

Step 1: Identify Connected Banks

• israeli-bank-mcp: Direct scraper integration
• il-bank-mcp: Docker-based with persistent analysis
• If no MCP: Guide user through CSV/Excel import from bank website

Step 2: Retrieve Transactions

• Default: Current month
• Supported: Up to 12 months history (bank-dependent)
• Include: Bank accounts AND credit card transactions

Step 3: Categorize and Analyze

Step 4: Present Insights

1. Monthly spending summary by category
2. Top 10 merchants by spending
3. Month-over-month trends
4. Recurring charges identified
5. Unusual transactions flagged

Step 5: Export for Tax (if requested)

• Separate business vs personal expenses
• Flag VAT-deductible purchases
• Export in format compatible with Israeli accounting software

Examples

Example 1: Monthly Spending Summary

Example 2: Subscription Audit

Example 3: Tax Expense Export

Bundled Resources

Scripts

• scripts/categorize_transactions.py

  — Categorizes Israeli bank transactions by spending category using Israeli-specific merchant pattern matching (Shufersal, Rami Levy, Rav-Kav, etc.). Accepts transaction JSON and outputs categorized spending summaries. Run:

  python scripts/categorize_transactions.py --example

  for a demo, or

  python scripts/categorize_transactions.py --json transactions.json

  for real data. Add

  --output-json

  for machine-readable output.

References

• references/spending-categories.md

  — Israeli spending category definitions with Hebrew terms and common merchant examples for each category (housing/diur, groceries/mazon, transportation/tahaburah, utilities/shartuim, etc.). Consult when customizing categorization rules or explaining categories to users.

• references/supported-banks.md

  — Full list of 14 banks (Hapoalim, Leumi, Discount, Mercantile, Mizrahi-Tefahot, FIBI, Otsar HaHayal, Pagi, Union, Yahav, Massad, OneZero, Behatsdaa, Beyahad Bishvilha) and 4 credit card companies (Visa Cal, Max, Isracard, Amex) from the

  israeli-bank-scrapers

  CompanyTypes

  enum, with BOI bank codes, library scraper IDs, and MCP server coverage notes. Consult when setting up bank connections or troubleshooting missing accounts.

Reference Links

Gotchas

• Israel's Open Banking regulation is based on the Berlin Group NextGenPSD2 framework but adapted for Israel with its own timeline and implementation. Full rollout across all banks is still ongoing (as of 2026). Agents may reference UK Open Banking or generic PSD2 endpoints that do not exist in Israel. In practice, israeli-bank-scrapers uses headless browser scraping, not official Open Banking APIs.
• Bank Leumi, Hapoalim, Discount, Mizrahi-Tefahot, and First International each have different API implementations. There is no single unified API across all Israeli banks.
• Mercantile and Otsar HaHayal are SEPARATE scrapers in the upstream library even though they are subsidiaries of Discount and FIBI respectively. Treat them as their own connection (each has its own loginFields shape). Do not assume Discount credentials cover Mercantile or that FIBI credentials cover Otsar HaHayal.
• Transaction history depth is bank-specific. Hapoalim and Leumi typically expose less than 12 months via scraping; FIBI-group banks (FIBI, Otsar HaHayal, Pagi) often expose 12+ months. Treat "up to 12 months" as a ceiling, not a promise.
• Israeli bank account numbers include a branch number (snif) prefix. Agents may validate account numbers using international IBAN format, but Israeli domestic transfers use the local branch+account format.
• Credit card statements in Israel are issued by separate companies (Isracard, Max, CAL) and not directly by the banks. Agents may try to fetch credit card data from the bank API instead of the card company.

Troubleshooting

Error: "2FA required"

Error: "Scraper timeout"

Error: "Missing credit card transactions"