# Israeli Cbs Mcp

> An Model Context Protocol (MCP) server that provides access to statistical data from the Israeli Central Bureau of Statistics (CBS).

- **Type:** MCP server
- **Install:** `agentstack add mcp-amirrosi-israeli-cbs-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [amirrosi](https://agentstack.voostack.com/s/amirrosi)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [amirrosi](https://github.com/amirrosi)
- **Source:** https://github.com/amirrosi/israeli-cbs-mcp

## Install

```sh
agentstack add mcp-amirrosi-israeli-cbs-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Israeli CBS MCP Server

An [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that provides access to statistical data from the **Israeli Central Bureau of Statistics (CBS)**.

It supports both **Statistical Series** (e.g., Unemployment, GDP) and **Price Indices** (e.g., CPI, Construction Inputs).

## Data Sources & API Documentation

This server retrieves data directly from the official CBS APIs:

*   **Statistical Series API**: [Documentation](https://www.cbs.gov.il/he/cbsNewBrand/Pages/%D7%A1%D7%93%D7%A8%D7%95%D7%AA-%D7%A2%D7%99%D7%AA%D7%99%D7%95%D7%AA-%D7%91%D7%90%D7%9E%D7%A6%D7%A2%D7%95%D7%AA-API.aspx)
*   **Price Indices API**: [Documentation](https://www.cbs.gov.il/he/cbsNewBrand/Pages/%D7%9E%D7%93%D7%93%D7%99-%D7%9E%D7%97%D7%99%D7%A8%D7%99%D7%9D-%D7%91%D7%90%D7%9E%D7%A6%D7%A2%D7%95%D7%AA-API.aspx)

## Features

-   **Hierarchical Exploration**: Navigate topics and subtopics (`list_main_topics`, `list_subtopics`).
-   **Unified Search**: Access both Statistical Series and Price Indices.
-   **Data Retrieval**: Fetch time-series data with year filtering (`get_series_data`).
-   **Smart Caching**: Builds a local index for fast lookups and offline navigation.
-   **Auto-Refresh**: Keeps the cache up-to-date with a background task.

## Indexing Behavior

Upon startup, the server traverses the entire CBS catalog to build a comprehensive local index.
- **Duration**: This process takes approximately **5 minutes**.
- **Cache Size**: The resulting index file is about **20MB**.
- **Availability**: The server is available immediately, but search/navigation tools will report "Index is building" until completion.

## Installation

### Using `uv` (Recommended)

```bash
uvx israeli-cbs-mcp
```

### From Source

1.  Clone the repository:
    ```bash
    git clone https://github.com/amirrosi/israeli-cbs-mcp.git
    cd israeli-cbs-mcp
    ```
2.  Install dependencies:
    ```bash
    pip install .
    ```

## Configuration

You can configure the server using environment variables:

| Variable | Description | Default |
| :--- | :--- | :--- |
| `CBS_CACHE_DIR` | Directory to store the index cache | `~/.cache/cbs_mcp` |
| `CBS_CACHE_DURATION_DAYS` | How long to keep the cache before full rebuild | `7` |
| `CBS_CACHE_REFRESH_INTERVAL` | Background refresh interval (seconds) | `86400` (24h) |
| `CBS_API_TIMEOUT` | API timeout in seconds | `30.0` |
| `CBS_MAX_RETRIES` | Number of API retries | `3` |

## Usage with Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cbs": {
      "command": "uvx",
      "args": ["israeli-cbs-mcp"]
    }
  }
}
```

## Tools

-   `list_main_topics(lang="he")`: List top-level categories.
-   `list_subtopics(parent_id, lang="he")`: List children of a category.
-   `get_series_data(series_id, start_year, end_year, last)`: Get data points.
-   `rebuild_index(lang="he")`: Force a manual index rebuild.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [amirrosi](https://github.com/amirrosi)
- **Source:** [amirrosi/israeli-cbs-mcp](https://github.com/amirrosi/israeli-cbs-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-amirrosi-israeli-cbs-mcp
- Seller: https://agentstack.voostack.com/s/amirrosi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.