OpenBudget MCP Server

by OpenBudget

Integrations

  • Supports the Creative Commons Attribution-ShareAlike 4.0 International License as one of the project's dual licensing options.

  • Integrates with the OpenBudget/BudgetKey GitHub project, enabling access to Israel's governmental budget data, contracts, and support payments.

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:

  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.
  2. For use with Claude AI Assistant:
fastmcp install server.py
  1. 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 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.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides access to Israel's OpenBudget API, allowing users to query and search various government budget datasets including budget items, contracts, and support payments.

  1. Description
    1. Features
      1. Requirements
        1. Installation
          1. Usage
            1. Available Datasets
              1. MCP Tools
                1. get_dataset_info
                2. search_dataset
                3. query_dataset
              2. MCP Resources
                1. available_datasets
              3. Error Handling
                1. API Documentation
                  1. Contributing
                    1. License

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        Enables interaction with Federal Election Commission data via the OpenFEC API, providing access to campaign finance information such as candidates, committees, contributions, and expenditures through the Model Context Protocol.
                        Last updated -
                        12
                        1
                        JavaScript
                        BSD 3-Clause
                        • Apple
                        • Linux
                      • A
                        security
                        F
                        license
                        A
                        quality
                        Connects to the US Treasury's Fiscal Data API, enabling users to fetch specific treasury statements, access historical data, and generate formatted reports.
                        Last updated -
                        12
                        6
                        TypeScript
                        • Apple
                      • A
                        security
                        F
                        license
                        A
                        quality
                        Enables AI assistants to interact with the World Bank open data API, allowing for listing and analysis of indicators across available countries.
                        Last updated -
                        1
                        8
                        Python
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A command-line interface and API that allows users to analyze and visualize AWS cloud spending data by enabling Claude to query AWS Cost Explorer through natural language conversations.
                        Last updated -
                        80
                        Python
                        MIT License
                        • Linux
                        • Apple

                      View all related MCP servers

                      ID: deyoehqdsd