data-gov-il-mcp

Production-grade Model Context Protocol (MCP) server for Israeli Government Open Data from data.gov.il.

This server gives MCP-compatible clients structured access to Israeli government datasets, resources, tags, organizations, and tabular records through the official CKAN API. It is written in TypeScript, validates inputs and outputs with Zod, returns JSON-first tool responses, and supports both local stdio and remote Streamable HTTP transports.

Highlights

Quick Start

Claude Desktop / Local Stdio

Use the published package directly:

{
  "mcpServers": {
    "data-gov-il": {
      "command": "npx",
      "args": ["-y", "data-gov-il-mcp"]
    }
  }
}

Streamable HTTP

npm install -g data-gov-il-mcp
data-gov-il-mcp-http

Then configure your MCP client:

{
  "mcpServers": {
    "data-gov-il": {
      "url": "http://localhost:3664/mcp"
    }
  }
}

Docker

docker run -p 3664:3664 ghcr.io/davidosherproceed/data-gov-il-mcp:latest

For local development:

npm install
npm run build
npm run start:stdio
# or
npm run start:http

Catalog Discovery Layer

The server ships with a committed catalog snapshot at src/data/catalog/catalog.snapshot.json. The snapshot is generated from data.gov.il and bundled into the build. At startup, it is validated and indexed in memory.

The discovery layer powers:

• find_datasets catalog-first search with live CKAN fallback.
• list_all_datasets instant local enumeration with optional organization filter.
• list_organizations instant local organization list with dataset counts.
• list_available_tags and search_tags from real CKAN tag/facet data.
• Dynamic completions for datagov://dataset/{id}.
• datagov://tags and datagov://catalog/stats resources.

It includes:

• Hebrew normalization, including nikud removal and final-letter normalization.
• Tokenization and trigram indexes for fuzzy matches and typo tolerance.
• Dataset, tag, and organization maps.
• Tag-to-dataset and organization-to-dataset indexes.
• Tag co-occurrence for related tag suggestions.
• Weighted ranking across exact, token, tag, organization, and fuzzy signals.

Refresh the snapshot:

npm run catalog:refresh
npm run build

A scheduled GitHub Actions workflow (.github/workflows/catalog-refresh.yml) refreshes the snapshot and opens a PR when catalog data changes.

More detail: docs/catalog-discovery-layer.md.

Tools

All successful tool responses return:

• structuredContent: the typed JSON object.
• content[0].text: the same object serialized as JSON for text-only clients.

Default Tools

Optional Tools

Elicitation in find_datasets

find_datasets can optionally expose an interactive parameter:

{
  "query": "תחבורה",
  "interactive": true
}

This is only registered when:

MCP_ENABLE_ELICITATION=true

When enabled, compatible clients may show a clarification form for broad searches. For example, the server can ask the user to narrow many matching datasets by publisher organization. If the client does not support Elicitation, the user declines, or the request times out, the tool falls back to normal search results.

This is disabled by default because MCP client support varies.

Resources

The server also implements resource subscriptions in a minimal standards-compliant way:

• Advertises resources.subscribe.
• Handles resources/subscribe and resources/unsubscribe.
• Sends notifications/resources/updated only for resources a client subscribed to.
• Does not poll CKAN in real time.

Prompts

Prompt arguments use MCP completions. Domain focus suggestions are curated, and organization completions are catalog-backed.

Optional MCP Client Features

These features are off by default. Enable them only when your target MCP client supports them and you want the server to expose them.

Client support differs:

• Cursor supports Elicitation, but does not currently expose Sampling.
• Claude Code supports Elicitation in recent versions.
• Claude Desktop supports many MCP features, but Elicitation support is not reliable/available.
• Sampling availability varies; the server always falls back safely.

Configuration

Copy .env.example to .env:

cp .env.example .env

Core

CKAN

HTTP Hardening

Authentication

Service Identity