ILBudget-mcp

@david-aftergut

About ILBudget-mcp

MCP Server for Israel budget

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ILBudget-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ILBudget-mcp?

ILBudget-mcp is a FastMCP server that interfaces with Israel's OpenBudget API, providing easy access to governmental budget data, contracts, and support payments. It serves as a bridge between the OpenBudget API and MCP clients.

How to use ILBudget-mcp?

Clone the repository, set up a Python virtual environment with uv, and install dependencies. You can then either install the server for use with Claude AI using fastmcp install ILBudgetServer.py or configure it for Visual Studio Code via the provided mcp.json file. For testing, run fastmcp dev ILBudgetServer.py.

Key features of ILBudget-mcp

Full access to Israel’s governmental budget data
Real-time integration with the OpenBudget API
Comprehensive search across multiple data categories
Historical budget tracking and analysis
Contract and support payment information retrieval
Easy-to-use MCP interface for client applications

Use cases of ILBudget-mcp

Analyze entire government budget structures
Retrieve detailed line items under a specific budget parent
Track historical spending for a budget code over time
Obtain contract information linked to a budget code
Search across budget, contract, and support categories with a query

FAQ from ILBudget-mcp

What is the difference between ILBudget-mcp and direct OpenBudget API usage?

ILBudget-mcp wraps the OpenBudget API into a standardized MCP interface, making it simpler for MCP-aware clients (e.g., Copilot, Claude) to access budget data without custom query construction.

What are the runtime requirements?

Python 3.10 or higher and the uv package manager are required. Dependencies include fastmcp (≥2.1.1) and requests (≥2.32.3).

Where does the budget data come from?

All data is pulled in real-time from the public OpenBudget API, which is maintained by the BudgetKey team. No data is stored locally by the server.

What transport and authentication does the server use?

The server uses the standard MCP protocol over the transport provided by the MCP client (e.g., Claude, VSCode). No authentication or API keys are mentioned in the README.

Is there a limit on the size or scope of queries?

The README does not specify any built-in limits; performance depends on the OpenBudget API’s response time and the client’s MCP implementation.

Frequently asked questions