@reuvenorg/israel-statistics-mcp
Version:
Model Context Protocol (MCP) server for Israeli Central Bureau of Statistics (CBS) price indices and economic data. Provides 9 tools for retrieving, analyzing, and calculating Israeli economic statistics including CPI, housing prices, producer indices, an
104 lines (75 loc) • 4.37 kB
Markdown
# Israel Statistics MCP
[](https://github.com/reuvenaor/israel-statistics-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@reuvenorg/israel-statistics-mcp)
[](https://hub.docker.com/r/reuvenaor/israel-statistics-mcp)
[](LICENSE)
**Ask your AI assistant about Israeli inflation, prices, and housing data — straight from the official Central Bureau of Statistics (CBS).**
Once installed, Claude (or any MCP-enabled assistant) can look up price indices, chart historical trends, and run the official CBS inflation calculator for you. No API key needed — the CBS data is free and public.
## Install
### Claude Desktop
Add this to your `claude_desktop_config.json` (Settings → Developer → Edit Config), then restart Claude:
```json
{
"mcpServers": {
"israel-statistics": {
"command": "npx",
"args": ["-y", "@reuvenorg/israel-statistics-mcp"]
}
}
}
```
### Claude Code
One command in your terminal:
```bash
claude mcp add israel-statistics -- npx -y @reuvenorg/israel-statistics-mcp
```
### Any other MCP client
Use the same `npx` command and args as above — that's all a client needs.
### Prefer Docker?
```json
{
"mcpServers": {
"israel-statistics": {
"command": "docker",
"args": [
"run",
"--init",
"--rm",
"-i",
"reuvenaor/israel-statistics-mcp:latest"
]
}
}
}
```
## What can I ask?
Just talk to your assistant naturally:
- _"How much is 1,000 ₪ from January 2015 worth today?"_
- _"What's the latest Israeli inflation number?"_
- _"Show me housing price trends from 2020 to 2024."_
- _"Which price indices exist for food? Compare bread vs. fresh vegetables."_
- _"Link my 2018 rent of 4,500 ₪ to today using the CPI."_
Answers come in Hebrew by default (it's the CBS default) — just ask in English to get English.
## What's inside
9 read-only tools your assistant uses behind the scenes:
| Tool | What it does |
| ---------------------------- | --------------------------------------------------- |
| `get_index_topics` | Search all price-index topics by keyword |
| `get_catalog_chapters` | List the index categories (CPI, housing, …) |
| `get_chapter_topics` | Topics inside one category |
| `get_subject_codes` | The concrete index codes for a topic |
| `get_index_data` | Historical values for one index |
| `get_index_calculator` | Official CBS inflation adjustment between two dates |
| `get_main_indices` | Today's headline indices |
| `get_main_indices_by_period` | Headline indices over a month range |
| `get_all_indices` | The full current-month index tree |
## Good to know
- **Housing data** updates every two months, and the last three published values are provisional — the server warns automatically when recent housing numbers may still change.
- **History depth varies** — the general CPI goes back decades; the headline month-range view starts at January 1997.
- **It's read-only and free** — the server only reads public CBS data over HTTPS (`api.cbs.gov.il`) and talks to nothing else. No account, no key, no tracking.
## For developers
Architecture, testing, CBS API details, security notes, and the release process live in [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md). Vulnerability reports: [SECURITY.md](SECURITY.md).
## Links
- **npm**: [@reuvenorg/israel-statistics-mcp](https://www.npmjs.com/package/@reuvenorg/israel-statistics-mcp) · **Docker**: [reuvenaor/israel-statistics-mcp](https://hub.docker.com/r/reuvenaor/israel-statistics-mcp) · **MCP Registry**: `io.github.reuvenaor/israel-statistics-mcp`
- **Data source**: [Israel Central Bureau of Statistics](https://www.cbs.gov.il/) · [Model Context Protocol](https://modelcontextprotocol.io/)
MIT License — see [LICENSE](LICENSE).