What is Il Bank Mcp

il-bank-mcp is a Model Context Protocol (MCP) server designed to facilitate access to financial data by automating the scraping of bank and credit card information from Israeli financial institutions.

Use cases

Use cases include tracking personal expenses, generating financial reports, analyzing spending trends, and providing insights into financial health through automated data aggregation.

How to use

To use il-bank-mcp, set up the server locally using Docker and configure it with your financial institution credentials. You can then interact with the server through compatible applications like Raycast or Claude Desktop.

Key features

Key features include automated data retrieval of transactions, financial summaries, account balances, and transaction searches. It supports dynamic configurations for various Israeli banks and credit card providers.

Where to use

il-bank-mcp is primarily used in the financial sector, particularly for personal finance management, budgeting, and financial analysis for users in Israel.

What is it?

IL Bank MCP is a finance assistant that brings your Israeli bank data to any AI assistant. It combines a headless scraper (powered by israeli-bank-scrapers) with an MCP server, letting LLMs analyze your transactions, track spending patterns, and provide financial insights.

✨ Demo

How to use IL Bank MCP?

Run it with Docker Compose for the quickest setup:

LEUMI_USERNAME=my_user LEUMI_PASSWORD=my_pass ... \
  docker compose up -d

Then add it to your AI assistant. For Raycast, use their MCP extension with:

docker compose -f /path/to/il-bank-mcp/docker-compose.yml run --rm -i mcp-server

For Claude Desktop, add to ~/.claude/config.jsonc:

{
  "mcpServers": {
    "israeli-bank-assistant": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "/path/to/il-bank-mcp/docker-compose.yml",
        "run",
        "--rm",
        "-i",
        "mcp-server"
      ],
      "env": {
        "LEUMI_USERNAME": "your_username",
        "LEUMI_PASSWORD": "your_password"
      }
    }
  }
}

See env.example for all credential and configuration options.

Key features of IL Bank MCP

• Smart Analysis: Get spending breakdowns, detect recurring charges, and track merchant patterns
• Local & Secure: All data stays in a local SQLite database
• Multi-Provider: Works with most Israeli banks and credit cards
• Real-time Updates: Refresh data on-demand from any provider
• On-Demand Sync: Scrape your bank data whenever you need fresh insights

What questions can I ask?

Here are some questions to get insights from your financial data:

• “Analyze spending patterns of Wolt”
• “Show me all subscriptions I’m paying for and their total monthly cost”
• “Show me all transactions over ₪1,000 in the last 30 days with their categories”
• “How much did I spend on groceries last month?”
• “Compare my spending this month vs last month”

What tools does IL Bank MCP provide?

• get_transactions - Fetch transactions for any time period
• get_financial_summary - Income, expenses, and trends at a glance
• search_transactions - Find specific transactions by amount or description
• get_monthly_credit_summary - Credit card usage breakdown
• get_recurring_charges - Find subscriptions and repeated payments
• analyze_merchant_spending - Spot unusual spending patterns
• refresh_all_data - Update from all connected accounts
• get_scrape_status - Check when data was last updated

FAQ from IL Bank MCP

Which banks are supported?
Any bank supported by israeli-bank-scrapers - includes Leumi, Hapoalim, Discount, and most credit card companies.

Is my data secure?
Yes. Everything runs locally on your machine. No data leaves your computer.

Can I use it with local LLMs?
Absolutely. Works great with Ollama through Raycast for a completely offline setup.

What if scraping fails?
Check the logs in ./logs. Most issues are login-related - verify your credentials match exactly what you use on the bank’s website.

Contributing

Early days - contributions welcome! 🙏

License

MIT

Acknowledgments

• israeli-bank-scrapers - Core scraping engine
• Model Context Protocol - MCP framework