Openbudget Mcp
What is Openbudget Mcp
OpenBudget-mcp is a FastMCP server designed to provide access to the OpenBudget API, enabling users to query and search various budget-related datasets, particularly focusing on Israel’s governmental budget data.
Use cases
Use cases for OpenBudget-mcp include analyzing government spending, tracking budget changes over time, retrieving contract information, and developing custom tools for budget visualization and reporting.
How to use
To use OpenBudget-mcp, clone the repository, set up a virtual environment using the uv package manager, and install the required dependencies. For integration with Visual Studio Code, configure the MCP settings to point to your local path.
Key features
Key features include 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, contract and support payment information retrieval, and an easy-to-use MCP interface for client applications.
Where to use
OpenBudget-mcp can be used in fields such as public finance, governmental budgeting, data analysis, and civic technology, where access to budget data is crucial for transparency and informed decision-making.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Openbudget Mcp
OpenBudget-mcp is a FastMCP server designed to provide access to the OpenBudget API, enabling users to query and search various budget-related datasets, particularly focusing on Israel’s governmental budget data.
Use cases
Use cases for OpenBudget-mcp include analyzing government spending, tracking budget changes over time, retrieving contract information, and developing custom tools for budget visualization and reporting.
How to use
To use OpenBudget-mcp, clone the repository, set up a virtual environment using the uv package manager, and install the required dependencies. For integration with Visual Studio Code, configure the MCP settings to point to your local path.
Key features
Key features include 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, contract and support payment information retrieval, and an easy-to-use MCP interface for client applications.
Where to use
OpenBudget-mcp can be used in fields such as public finance, governmental budgeting, data analysis, and civic technology, where access to budget data is crucial for transparency and informed decision-making.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
OpenBudget MCP Server
An MCP server that provides access to the OpenBudget API, allowing you to query and search various budget-related datasets.
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.
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 OpenBudget-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:
-
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.
-
For use with Claude AI Assistant:
fastmcp install server.py
- For testing with MCP Inspector (Learn how at MCP Inspector):
fastmcp dev server.py
Available Datasets
The following datasets are available:
- budget_items_data
- income_items_data
- supports_data
- contracts_data
- entities_data
- budgetary_change_requests_data
- budgetary_change_transactions_data
MCP Tools
get_dataset_info
Get information about a dataset’s structure, including its columns and database schema.
search_dataset
Perform a full-text search within a dataset.
query_dataset
Execute SQL queries on a dataset.
MCP Resources
available_datasets
Get a list of all available datasets.
Error Handling
The tools will return appropriate error messages in the following cases:
- Invalid dataset name
- Invalid SQL query
- API request failures
- Network connectivity issues
API Documentation
The server is based on the OpenBudget API. For more details about the API endpoints and data structure, refer to the OpenAPI specification in budgetkey.yaml.
Contributing
We welcome contributions to help improve the BudgetKey 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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
