e5acb70cd9d66ddf.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","4902","static/chunks/4902-40271c136eb736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 24:Td21,# 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](https://github.com/OpenBudget/BudgetKey) team.
See their [UsingTheAPI](https://github.com/OpenBudget/BudgetKey/blob/master/documentation/UsingTheAPI.md) 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](http://data.obudget.org/) to test them (You can see my queries in [ILBudgetServer.py](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](https://docs.astral.sh/uv/) package manager ## Installation ```bash git clone 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)](https://code.visualstudio.com/download):
Go to [vscode/mcp.json](/.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](vscode://settings/mcp).
Make sure to enable agent mode in your vscode copilot.
![Agent Mode Enabled](AgentModeEnabled.png) 2. For use with [Claude AI Assistant](https://claude.ai): ```bash fastmcp install ILBudgetServer.py ``` 3. For testing with MCP Inspector (Learn how at [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector)): ```bash 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](https://github.com/modelcontextprotocol/servers). ## License This project is dual-licensed under: - MIT License - Creative Commons Attribution-ShareAlike 4.0 International License See the [LICENSE](LICENSE) file for details.25:T46d