mcpField
I
IL Bank MCP 🐷💸

IL Bank MCP 🐷💸

Local
github.com/gleknerFinance13Updated 72w ago
Repository

About IL Bank MCP 🐷💸

IL Bank MCP scrapes Israeli bank and credit card data into a local database and makes it available for analysis by AI assistants. It is intended for people who want to examine spending, subscriptions, and transaction trends.

Key features

  1. 01Scrapes Israeli bank and card data
  2. 02Retrieves transactions by date range
  3. 03Summarizes income, expenses, and trends
  4. 04Finds recurring charges and merchant spending
  5. 05Refreshes account data on demand
  6. 06Stores data in a local SQLite database

Use cases

  1. 01Compare spending across two months
  2. 02Total subscriptions and monthly costs
  3. 03Find transactions by amount or description
  4. 04Analyze spending at a specific merchant

MCP support

The MCP server provides clients with tools for transaction lookup, financial summaries, recurring-charge and merchant analysis, data refresh, and scrape status.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "il-bank": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
Run commanddocker run -i --rm compose

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocicompose

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

IL Bank MCP 🐷💸

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

Raycast MCP Server running

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
image

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.