mcpField
I
ILBudget-mcp

ILBudget-mcp

Local
github.com/david-aftergutLegal & Government2Updated 78w ago
Repository

About ILBudget-mcp

ILBudget-mcp is a FastMCP server for accessing Israeli government budget data through the OpenBudget API. Its tools cover budget structures and history, contracts, support payments, and cross-category search.

Key features

  1. 01Retrieve budget structure
  2. 02Inspect detailed budget items
  3. 03Track budget-code history
  4. 04Retrieve contracts and support payments
  5. 05Search across data categories

Use cases

  1. 01Review historical figures for a budget code
  2. 02Find contract details by code
  3. 03Retrieve support payment information
  4. 04Search Israeli budget data

MCP support

It bridges the OpenBudget API to MCP clients, exposing tools for budget data, historical records, contracts, support payments, and search.

Configuration

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

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

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

ILBudget-mcp

MCP Server for accessing Israeli budget data through the OpenBudget API.

Description

This project provides a FastMCP server that interfaces with Israel's OpenBudget data.
Allowing easy access to budget data, contracts, and supports information.
It serves as a bridge between the OpenBudget API and MCP clients.

This project is possible only thanks to amazing work of OpenBudget/BudgetKey team.
See their UsingTheAPI for more details about the API used in this MCP server.
If you wish to craft your own queries or tool you can use their Redash to test them (You can see my queries in ILBudgetServer.py).

Features

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

Requirements

  • Python 3.10 or higher
  • uv package manager

Installation

git clone <repository-url>
cd ILBudget-mcp
uv venv
.venv\Scripts\activate
uv pip install -r pyproject.toml
uv lock

Usage

Install and run the server using one of these methods:

  1. For use with Visual Studio Code (using Copilot):
    Go to vscode/mcp.json and replace {YOUR-LOCAL-PATH} with the path you cloned the repo.
    VSCode should discover you server automatically.
    If that doesn't work, make sure you enabled MCP & MCP.Discovery in vscode://settings/mcp.
    Make sure to enable agent mode in your vscode copilot.
    Agent Mode Enabled

  2. For use with Claude AI Assistant:

fastmcp install ILBudgetServer.py
  1. For testing with MCP Inspector (Learn how at MCP Inspector):
fastmcp dev ILBudgetServer.py
Available Tools
  • get_budget() - Retrieves the entire budget structure
  • get_detailed_budget_for_specific_parent(parent) - Gets detailed budget items under a specific parent
  • get_budget_history_for_code(code) - Retrieves historical data for a specific budget code
  • get_contract(code) - Gets contract information for a specific budget code
  • get_supports(code) - Retrieves support payment information for a specific budget code
  • search(searchTerm, searchType) - Performs a general search across different categories

Dependencies

  • fastmcp >= 2.1.1
  • requests >= 2.32.3

Contributing

We welcome contributions to help improve the DataGov Israel MCP server.
Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see the Model Context Protocol servers repository.

License

This project is dual-licensed under:

  • MIT License
  • Creative Commons Attribution-ShareAlike 4.0 International License

See the LICENSE file for details.

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.