Israel Statistics

You can access Israel’s Central Bureau of Statistics price indices and economic data through a TypeScript-based MCP server. It provides programmatic endpoints to retrieve, analyze, and calculate key Israeli economic statistics with built‑in validation, error handling, and flexible data formats.

How to use

You interact with the server through an MCP client to query index topics, chapters, subjects, and codes, retrieve historical data, perform inflation calculations, and access current main indices. Use the available tools to explore data catalogs, fetch index data, and compute inflation-adjusted values. The server handles input validation, error management, and data transformation between CBS API formats (XML/JSON) and your preferred response format.

How to install

Prerequisites: you need Docker installed to use the recommended container workflow, or Node.js with NPX to run the MCP server without a container.

// Docker (Recommended) via MCP config snippet
{
  "israel-statistics-mcp": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "reuvenaor/israel-statistics-mcp:latest"]
  }
}

// NPX run via MCP config snippet
{
  "israel-statistics-mcp": {
    "command": "npx",
    "args": ["@reuvenorg/israel-statistics-mcp"]
  }
}

Optional quick setup for Claude Desktop Integration is provided as a convenience to add the MCP client to a project. Ensure you have Claude configured to run MCP commands.

Additional setup and notes

Security and reliability features are built in to protect your usage: a limit of five concurrent operations, strict input validation, and 30-second HTTP timeouts. The server gracefully handles CBS API errors and can transform XML responses to JSON for easier consumption.

The Housing Price Index data have special handling: it updates bi-monthly, may reflect a lag of 2–3 months, and provisional data can be revised. The system automatically warns when provisional periods are involved and provides recommendations on their use.

Examples of data access and calculations

Browse index topics, chapters, and subjects to locate codes, then fetch historical data or compute inflation-adjusted values using the available tools. Use the built-in search and pagination to navigate large datasets.

For a sample workflow, first identify a code with get_index_topics, then retrieve its data with get_index_data, and finally compute an adjusted value with get_index_calculator.

Development and testing notes

The server is built with TypeScript and validates inputs/outputs with Zod. A comprehensive test suite covers unit tests, integration tests with the CBS API, and mock testing. Development commands include build, typecheck, and test actions, plus linting and formatting checks.

Available tools

get_index_topics

Browse all available index categories and topics with optional period, search text, and language parameters.

get_catalog_chapters

Get all index chapters (CPI, Housing, etc.) with language and page size controls.

get_chapter_topics

Get topics within a specific chapter identified by chapterId and language.

get_subject_codes

Get index codes for a specific topic using subjectId and optional search text.

get_index_data

Retrieve historical price data for a given index code over a specified period range.

get_index_calculator

Calculate inflation-adjusted values for a given index over a date range.

get_main_indices

Get current main economic indices with options for formatting and language.

get_all_indices

Get comprehensive index data with filtering across chapters.