mcp-il-professionals 0.1.0__tar.gz

mcp_il_professionals-0.1.0/.dockerignore

@@ -0,0 +1,6 @@
+.git
+.venv
+__pycache__
+.pytest_cache
+.ruff_cache
+tests

mcp_il_professionals-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to PyPI and MCP Registry
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: pytest
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # PyPI trusted publishing + MCP Registry GitHub OIDC
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Check tag matches versions
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PY=$(python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          SJ=$(python -c "import json;print(json.load(open('server.json'))['version'])")
+          test "$TAG" = "$PY" && test "$TAG" = "$SJ" || { echo "tag=$TAG pyproject=$PY server.json=$SJ"; exit 1; }
+      - run: pip install build && python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz" | tar xz mcp-publisher
+      - name: Wait for PyPI to serve the new version
+        run: sleep 60
+      - name: Publish to MCP Registry
+        run: |
+          ./mcp-publisher login github-oidc
+          ./mcp-publisher publish

mcp_il_professionals-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+.venv/
+.env
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+*.egg-info/

mcp_il_professionals-0.1.0/.mcp.json

@@ -0,0 +1,5 @@
+{
+  "mcpServers": {
+    "il-professionals": { "command": "mcp-il-professionals" }
+  }
+}

mcp_il_professionals-0.1.0/CLAUDE.md

@@ -0,0 +1,26 @@
+# mcp-il-professionals — CLAUDE.md
+
+Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, appraisers, CPAs, surveyors, private investigators — live from data.gov.il.
+
+## Stack
+Python 3.11 · FastMCP · httpx · pytest. No database: every tool queries data.gov.il CKAN `datastore_search` live.
+
+## Layout
+- server.py — Prefect Horizon entrypoint (`server.py:mcp`); check with `fastmcp inspect server.py:mcp`
+- src/mcp_il_professionals/server.py — tools + resource IDs (constants `R_*` at top)
+- src/mcp_il_professionals/ckan.py — shared CKAN client (retries, User-Agent, `~`→`"` cleanup, `meta()` provenance). Keep identical across mcp-il-* repos.
+- tests/ — offline tests (monkeypatched `datastore_search`); `pytest -m live` for real calls
+
+## Rules
+- Every tool response includes `source`, `retrieved_at`, `attribution` via `meta()`.
+- Resource IDs can change when a ministry republishes — if a tool returns 404/empty, re-resolve with
+  `package_search` and update the `R_*` constant.
+- Exact matches via `filters` (numbers must be int unless the dataset stores strings); free text via `q`.
+- Never store or log personal queries. Data is public registry data only.
+- Update MEMORY.md at the end of every session.
+
+## Model routing
+Architect/Advisor: Fable (else Opus) · Orchestrator: Opus · Executor: Sonnet · Explorer/tests: Haiku · tiny text jobs: Jetson llama.cpp · graphics: Gemini/ChatGPT.
+
+## Deployment
+Prefect Horizon free tier (public HTTP), entrypoint `server.py:mcp`. data.gov.il is reachable from cloud hosts.

mcp_il_professionals-0.1.0/Dockerfile

@@ -0,0 +1,9 @@
+FROM python:3.12-slim
+WORKDIR /app
+COPY pyproject.toml README.md LICENSE ./
+COPY src ./src
+RUN pip install --no-cache-dir .
+ENV MCP_TRANSPORT=http PORT=8000
+EXPOSE 8000
+USER nobody
+CMD ["mcp-il-professionals"]

mcp_il_professionals-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleg Sher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_il_professionals-0.1.0/MEMORY.md

@@ -0,0 +1,14 @@
+# mcp-il-professionals — MEMORY.md
+
+## Status (2026-11-14)
+- v0.1.0 built and tested against live data.gov.il; repo https://github.com/olegsher-ds-2025/mcp-il-professionals
+- PyPI + MCP Registry publishing via GitHub Actions on tag v*; Horizon free tier is private-only (public needs paid plan) → self-host on laptop 10.0.0.100 via Cloudflare Tunnel (mcp-il-deploy)
+
+## Next tasks
+1. Deploy to Prefect Horizon; add hosted URL to README
+2. List on MCP Registry, Glama, Smithery, agentskills.co.il
+3. Roadmap items in README
+
+## Facts
+- data.gov.il CKAN reachable from Claude cloud workspace and cloud hosts (unlike cbs.gov.il)
+- Registry text encodes `"` as `~` — cleaned in ckan.clean_value

mcp_il_professionals-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: mcp-il-professionals
+Version: 0.1.0
+Summary: Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, appraisers, CPAs, surveyors, private investigators — live from data.gov.il
+Project-URL: Repository, https://github.com/olegsher-ds-2025/mcp-il-professionals
+Author: Oleg Sher
+License: MIT
+License-File: LICENSE
+Keywords: data.gov.il,israel,mcp,model-context-protocol,open-data
+Requires-Python: >=3.11
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# mcp-il-professionals
+
+<!-- mcp-name: io.github.olegsher-ds-2025/mcp-il-professionals -->
+
+Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, appraisers, CPAs, surveyors, private investigators — live from data.gov.il.
+
+**אימות בעלי מקצוע מורשים: מתווכים, קבלנים רשומים, שמאים, רואי חשבון, מודדים, חוקרים פרטיים**
+
+An [MCP](https://modelcontextprotocol.io) server that lets Claude and other AI assistants query official Israeli
+government open data in plain language. No API key, no scraping — every call goes to the public
+[data.gov.il](https://data.gov.il) CKAN API and returns the source with each answer.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_professions` | Which registries are available, and how to verify electricians / engineers / lawyers |
+| `verify_professional` | Check a licence by name or number in one registry |
+| `find_contractors` | Registered contractors by city, branch (שיפוצים, בניה, חשמלאות…), classification |
+| `contractor_profile` | All branches & classifications of one contractor |
+| `search_all_registries` | One name across every registry |
+| `health` | Connectivity check |
+
+## Try asking
+
+- “Is the real-estate broker דורית גריצר licensed?”
+- “Find registered renovation contractors in Modiin recognized for government work.”
+- “Check CPA licence 5005603.”
+- “What licences does this person hold across all registries?”
+
+## Install
+
+No install needed with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uvx mcp-il-professionals
+```
+
+Claude Desktop / Claude Code (`.mcp.json`):
+
+```json
+{ "mcpServers": { "il-professionals": { "command": "uvx", "args": ["mcp-il-professionals"] } } }
+```
+
+Or `pip install mcp-il-professionals`, or from source: `pip install git+https://github.com/olegsher-ds-2025/mcp-il-professionals`.
+
+Also listed in the official MCP Registry as `io.github.olegsher-ds-2025/mcp-il-professionals`.
+
+Run over HTTP (for remote hosting):
+
+```bash
+MCP_TRANSPORT=http PORT=8000 mcp-il-professionals   # → http://localhost:8000/mcp
+```
+
+Docker: `docker build -t mcp-il-professionals . && docker run -p 8000:8000 mcp-il-professionals`.
+
+Prefect Horizon entrypoint: `server.py:mcp`.
+
+## Data sources
+
+- Licensed real-estate brokers (Ministry of Justice)
+- Registered contractors (Registrar of Contractors)
+- Real-estate appraisers
+- Certified public accountants (CPA Council)
+- Vehicle appraisers (Ministry of Transport)
+- Licensed surveyors (Survey of Israel)
+- Private investigators & investigation firms
+
+All data © the publishing Israeli government authority, via data.gov.il. This project is independent and not
+affiliated with the Government of Israel. Registry data can lag; verify critical facts with the authority.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest            # offline tests
+pytest -m live    # hits data.gov.il
+```
+
+## Roadmap
+
+- [ ] Electricians licence search (Ministry of Labor — not open data; investigate official lookup)
+- [ ] Engineers & architects registry
+- [ ] Insurance agents (Capital Market Authority)
+- [ ] Join contractors with mcp-il-companies due_diligence
+
+## Related
+
+Part of a family of Israeli public-data MCP servers by [Oleg Sher](https://linkedin.com/in/sheroleg):
+mcp-il-companies · mcp-il-vehicles · mcp-il-health · mcp-il-professionals · mcp-cbs-places · mcp-mavat.
+
+## License
+
+MIT

mcp_il_professionals-0.1.0/README.md

@@ -0,0 +1,94 @@
+# mcp-il-professionals
+
+<!-- mcp-name: io.github.olegsher-ds-2025/mcp-il-professionals -->
+
+Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, appraisers, CPAs, surveyors, private investigators — live from data.gov.il.
+
+**אימות בעלי מקצוע מורשים: מתווכים, קבלנים רשומים, שמאים, רואי חשבון, מודדים, חוקרים פרטיים**
+
+An [MCP](https://modelcontextprotocol.io) server that lets Claude and other AI assistants query official Israeli
+government open data in plain language. No API key, no scraping — every call goes to the public
+[data.gov.il](https://data.gov.il) CKAN API and returns the source with each answer.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_professions` | Which registries are available, and how to verify electricians / engineers / lawyers |
+| `verify_professional` | Check a licence by name or number in one registry |
+| `find_contractors` | Registered contractors by city, branch (שיפוצים, בניה, חשמלאות…), classification |
+| `contractor_profile` | All branches & classifications of one contractor |
+| `search_all_registries` | One name across every registry |
+| `health` | Connectivity check |
+
+## Try asking
+
+- “Is the real-estate broker דורית גריצר licensed?”
+- “Find registered renovation contractors in Modiin recognized for government work.”
+- “Check CPA licence 5005603.”
+- “What licences does this person hold across all registries?”
+
+## Install
+
+No install needed with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uvx mcp-il-professionals
+```
+
+Claude Desktop / Claude Code (`.mcp.json`):
+
+```json
+{ "mcpServers": { "il-professionals": { "command": "uvx", "args": ["mcp-il-professionals"] } } }
+```
+
+Or `pip install mcp-il-professionals`, or from source: `pip install git+https://github.com/olegsher-ds-2025/mcp-il-professionals`.
+
+Also listed in the official MCP Registry as `io.github.olegsher-ds-2025/mcp-il-professionals`.
+
+Run over HTTP (for remote hosting):
+
+```bash
+MCP_TRANSPORT=http PORT=8000 mcp-il-professionals   # → http://localhost:8000/mcp
+```
+
+Docker: `docker build -t mcp-il-professionals . && docker run -p 8000:8000 mcp-il-professionals`.
+
+Prefect Horizon entrypoint: `server.py:mcp`.
+
+## Data sources
+
+- Licensed real-estate brokers (Ministry of Justice)
+- Registered contractors (Registrar of Contractors)
+- Real-estate appraisers
+- Certified public accountants (CPA Council)
+- Vehicle appraisers (Ministry of Transport)
+- Licensed surveyors (Survey of Israel)
+- Private investigators & investigation firms
+
+All data © the publishing Israeli government authority, via data.gov.il. This project is independent and not
+affiliated with the Government of Israel. Registry data can lag; verify critical facts with the authority.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest            # offline tests
+pytest -m live    # hits data.gov.il
+```
+
+## Roadmap
+
+- [ ] Electricians licence search (Ministry of Labor — not open data; investigate official lookup)
+- [ ] Engineers & architects registry
+- [ ] Insurance agents (Capital Market Authority)
+- [ ] Join contractors with mcp-il-companies due_diligence
+
+## Related
+
+Part of a family of Israeli public-data MCP servers by [Oleg Sher](https://linkedin.com/in/sheroleg):
+mcp-il-companies · mcp-il-vehicles · mcp-il-health · mcp-il-professionals · mcp-cbs-places · mcp-mavat.
+
+## License
+
+MIT

mcp_il_professionals-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-il-professionals"
+version = "0.1.0"
+description = "Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, appraisers, CPAs, surveyors, private investigators — live from data.gov.il"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Oleg Sher" }]
+keywords = ["mcp", "israel", "open-data", "data.gov.il", "model-context-protocol"]
+dependencies = ["fastmcp>=2.0", "httpx>=0.27"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "ruff>=0.5"]
+
+[project.scripts]
+mcp-il-professionals = "mcp_il_professionals.server:main"
+
+[project.urls]
+Repository = "https://github.com/olegsher-ds-2025/mcp-il-professionals"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_il_professionals"]
+
+[tool.ruff]
+line-length = 140
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = ["live: hits data.gov.il (run with -m live)"]
+addopts = "-m 'not live'"

mcp_il_professionals-0.1.0/server.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.olegsher-ds-2025/mcp-il-professionals",
+  "title": "Israel Licensed Professionals",
+  "description": "Verify licensed professionals in Israel for AI agents: real-estate brokers, registered contractors, ",
+  "repository": {
+    "url": "https://github.com/olegsher-ds-2025/mcp-il-professionals",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "mcp-il-professionals",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

mcp_il_professionals-0.1.0/server.py

@@ -0,0 +1,7 @@
+"""Prefect Horizon entrypoint: server.py:mcp"""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent / "src"))
+
+from mcp_il_professionals.server import mcp  # noqa: E402,F401

mcp_il_professionals-0.1.0/src/mcp_il_professionals/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

mcp_il_professionals-0.1.0/src/mcp_il_professionals/ckan.py

@@ -0,0 +1,81 @@
+"""Minimal async client for the data.gov.il CKAN datastore API."""
+from __future__ import annotations
+
+import asyncio
+import json
+from datetime import UTC, datetime
+from typing import Any
+
+import httpx
+
+BASE_URL = "https://data.gov.il/api/3/action"
+USER_AGENT = "mcp-il/0.1 (+https://github.com/olegsher-ds-2025)"
+TIMEOUT = httpx.Timeout(30.0)
+
+_DROP = {"_id", "rank", "_full_text"}
+
+
+class CkanError(RuntimeError):
+    pass
+
+
+def clean_value(v: Any) -> Any:
+    """data.gov.il registries encode a double quote as '~' (e.g. בע~מ -> בע"מ)."""
+    if isinstance(v, str):
+        v = v.replace("~", '"').strip()
+        return v or None
+    return v
+
+
+def clean_record(rec: dict) -> dict:
+    return {k: clean_value(v) for k, v in rec.items() if k not in _DROP}
+
+
+async def datastore_search(
+    resource_id: str,
+    *,
+    filters: dict | None = None,
+    q: str | dict | None = None,
+    limit: int = 10,
+    offset: int = 0,
+    fields: list[str] | None = None,
+    sort: str | None = None,
+    retries: int = 3,
+) -> dict:
+    """Query one datastore resource. Returns {'total': int, 'records': [cleaned dicts]}."""
+    params: dict[str, Any] = {"resource_id": resource_id, "limit": max(1, min(limit, 1000)), "offset": offset}
+    if filters:
+        params["filters"] = json.dumps(filters, ensure_ascii=False)
+    if q:
+        params["q"] = json.dumps(q, ensure_ascii=False) if isinstance(q, dict) else q
+    if fields:
+        params["fields"] = ",".join(fields)
+    if sort:
+        params["sort"] = sort
+
+    last_exc: Exception | None = None
+    async with httpx.AsyncClient(timeout=TIMEOUT, headers={"User-Agent": USER_AGENT}) as client:
+        for attempt in range(retries):
+            try:
+                r = await client.get(f"{BASE_URL}/datastore_search", params=params)
+                r.raise_for_status()
+                body = r.json()
+                if not body.get("success"):
+                    raise CkanError(str(body.get("error")))
+                res = body["result"]
+                return {"total": res.get("total", 0), "records": [clean_record(x) for x in res.get("records", [])]}
+            except (httpx.HTTPError, CkanError, ValueError) as exc:
+                last_exc = exc
+                await asyncio.sleep(1.5 * (attempt + 1))
+    raise CkanError(f"data.gov.il query failed for {resource_id}: {last_exc}")
+
+
+def meta(dataset: str | list[str]) -> dict:
+    """Standard provenance block added to every tool response."""
+    names = [dataset] if isinstance(dataset, str) else dataset
+    return {
+        "source": "data.gov.il — " + "; ".join(names),
+        "retrieved_at": datetime.now(UTC).isoformat(timespec="seconds"),
+        "attribution": "Israeli government open data (data.gov.il). Not an official service; verify critical facts "
+        "with the publishing authority.",
+    }

mcp_il_professionals-0.1.0/src/mcp_il_professionals/server.py

@@ -0,0 +1,250 @@
+"""mcp-il-professionals — verify licensed professionals in Israel: real-estate brokers, registered
+contractors, real-estate appraisers, CPAs, vehicle appraisers, licensed surveyors and private investigators.
+Live data from data.gov.il (Ministries of Justice, Construction & Housing, Transport, Survey of Israel, CPA Council)."""
+from __future__ import annotations
+
+import asyncio
+import os
+
+from fastmcp import FastMCP
+
+from .ckan import datastore_search, meta
+
+R_BROKERS = "a0f56034-88db-4132-8803-854bcdb01ca1"  # מאגר מתווכים פעילים
+R_CONTRACTORS = "4eb61bd6-18cf-4e7c-9f9c-e166dfa0a2d8"  # פנקס הקבלנים הרשומים
+R_APPRAISERS = "8540534a-eccd-4568-a677-652d589ed172"  # מאגר שמאי מקרקעין
+R_CPAS = "7e86def9-0899-45f4-8942-d6fe38482b1a"  # מאגר רואי החשבון
+R_VEHICLE_APPRAISERS = "4a434d65-3ca2-45e5-8026-5d9819c3f95c"  # שמאי רכב
+R_SURVEYORS = "096e5fba-420c-4822-8172-78be54767cef"  # רשימת המודדים (מפ"י)
+R_INVESTIGATORS = "a9ddb445-825f-4635-a573-fe82d2a95bf0"  # חוקרים פרטיים
+R_INVESTIGATION_FIRMS = "94722051-b0c7-4f73-b543-c558c6c2c660"  # תאגידי חוקרים פרטיים
+
+
+def _broker(r):
+    return {"name": r.get("שם המתווך"), "license_number": r.get("מס רשיון"), "city": r.get("עיר מגורים"),
+            "status": "active (listed in the active brokers registry)"}
+
+
+def _appraiser(r):
+    return {"name": r.get("שם שמאי"), "license_number": r.get("מספר רשיון"), "file_number": r.get("מספר תיק"),
+            "city": r.get("עיר")}
+
+
+def _cpa(r):
+    return {"first_name": r.get("שם פרטי"), "last_name": r.get("שם משפחה"), "license_number": r.get("מספר רישיון"),
+            "licensed_since": r.get("תאריך קבלת רישיון"), "city": r.get("ישוב"), "status": r.get("סטטוס")}
+
+
+def _vehicle_appraiser(r):
+    return {"first_name": r.get("shem_prati"), "last_name": r.get("shem_mishpaha"),
+            "license_number": r.get("mispar_rishayon"), "city": r.get("yishuv")}
+
+
+def _surveyor(r):
+    return {"first_name": r.get("name1"), "last_name": r.get("family_name"), "license_number": r.get("number"),
+            "status": r.get("status"), "notes": r.get("information"), "certificate": r.get("cer_link")}
+
+
+def _investigator(r):
+    return {"first_name": r.get("שם פרטי"), "last_name": r.get("שם משפחה"), "license_number": r.get("מספר רישיון")}
+
+
+def _investigation_firm(r):
+    return {"firm": r.get("שם תאגיד"), "license_number": r.get("מספר רישיון")}
+
+
+def _contractor(r):
+    return {
+        "name": r.get("SHEM_YESHUT"), "contractor_number": r.get("MISPAR_KABLAN"),
+        "company_or_id_number": r.get("MISPAR_YESHUT"), "branch": " ".join((r.get("TEUR_ANAF") or "").split()) or None,
+        "branch_code": r.get("KOD_ANAF"), "group": r.get("KVUTZA"), "classification": r.get("SIVUG"),
+        "classification_since": r.get("TARICH_SUG"), "registered_since": (r.get("TAARICH_KABLAN") or "")[:10] or None,
+        "recognized_for_government_work": r.get("KABLAN_MUKAR"), "city": r.get("SHEM_YISHUV"),
+        "address": " ".join(x for x in (r.get("SHEM_REHOV"), r.get("MISPAR_BAIT")) if x) or None,
+        "phone": r.get("MISPAR_TEL"), "email": r.get("EMAIL"), "qualified_manager": r.get("OVDIM"),
+        "notes": r.get("HEARA"),
+    }
+
+
+# profession -> (resource, mapper, license field, dataset label)
+REGISTRIES = {
+    "real_estate_broker": (R_BROKERS, _broker, "מס רשיון", "Ministry of Justice — licensed real-estate brokers"),
+    "real_estate_appraiser": (R_APPRAISERS, _appraiser, "מספר רשיון", "Ministry of Justice — real-estate appraisers"),
+    "cpa": (R_CPAS, _cpa, "מספר רישיון", "CPA Council — certified public accountants"),
+    "vehicle_appraiser": (R_VEHICLE_APPRAISERS, _vehicle_appraiser, "mispar_rishayon",
+                          "Ministry of Transport — vehicle appraisers"),
+    "surveyor": (R_SURVEYORS, _surveyor, "number", "Survey of Israel — licensed surveyors"),
+    "private_investigator": (R_INVESTIGATORS, _investigator, "מספר רישיון",
+                             "Ministry of Justice — private investigators"),
+    "investigation_firm": (R_INVESTIGATION_FIRMS, _investigation_firm, "מספר רישיון",
+                           "Ministry of Justice — private investigation firms"),
+    "contractor": (R_CONTRACTORS, _contractor, "MISPAR_KABLAN", "Registrar of Contractors — registered contractors"),
+}
+STRING_LICENSE = {"contractor"}  # stored as text in the dataset
+
+NOT_OPEN = {
+    "electrician": {
+        "regulator": "Ministry of Labor — Electricians Licensing Unit (המחלקה לרישוי חשמלאים)",
+        "how_to_verify": "Ask for the licence number and ID; check it in the Ministry of Labor online electrician "
+                         "licence search. Licence grade matters (e.g. מוסמך / ראשי / בודק).",
+        "info_page": "https://www.gov.il/he/departments/units/electricity-licensing-unit",
+    },
+    "engineer_or_architect": {
+        "regulator": "Ministry of Labor — Registrar of Engineers and Architects (פנקס המהנדסים והאדריכלים)",
+        "how_to_verify": "Use the Registrar's online search on gov.il; registration and licence are separate steps.",
+    },
+    "lawyer": {
+        "regulator": "Israel Bar Association",
+        "how_to_verify": "Use the Bar Association's public lawyer search.",
+    },
+}
+
+mcp = FastMCP(
+    "mcp-il-professionals",
+    instructions=(
+        "Verify Israeli licensed professionals before hiring. Professions: " + ", ".join(REGISTRIES)
+        + ". Use find_contractors for registered building contractors by city/branch. Electricians, engineers and "
+        "lawyers are not in open data — call list_professions for how to verify them. Names are Hebrew."
+    ),
+)
+
+
+@mcp.tool
+async def list_professions() -> dict:
+    """Which professions can be verified here, and how to verify those that are not open data
+    (electricians, engineers/architects, lawyers)."""
+    return {
+        "available": {k: v[3] for k, v in REGISTRIES.items()},
+        "not_in_open_data": NOT_OPEN,
+        **meta("data.gov.il catalogue"),
+    }
+
+
+@mcp.tool
+async def verify_professional(profession: str, name: str = "", license_number: str = "", city: str = "",
+                              limit: int = 20) -> dict:
+    """Check that a person or firm holds a licence in an Israeli professional registry.
+
+    Args:
+        profession: one of real_estate_broker, real_estate_appraiser, cpa, vehicle_appraiser, surveyor,
+            private_investigator, investigation_firm, contractor (or electrician / engineer_or_architect /
+            lawyer — returns how to verify, these are not open data).
+        name: full or partial name in Hebrew (e.g. "גריצר דורית").
+        license_number: licence / registration number (exact match).
+        city: optional city text to narrow name searches.
+    """
+    if profession in NOT_OPEN:
+        return {"profession": profession, "open_data": False, **NOT_OPEN[profession]}
+    if profession not in REGISTRIES:
+        raise ValueError(f"Unknown profession. Choose from: {', '.join(list(REGISTRIES) + list(NOT_OPEN))}")
+    rid, mapper, lic_field, label = REGISTRIES[profession]
+    if license_number:
+        digits = "".join(ch for ch in license_number if ch.isdigit())
+        value = digits if profession in STRING_LICENSE else int(digits)
+        res = await datastore_search(rid, filters={lic_field: value}, limit=20)
+    elif name:
+        q = " ".join(x for x in (name, city) if x)
+        res = await datastore_search(rid, q=q, limit=max(1, min(limit, 100)))
+    else:
+        raise ValueError("Provide name or license_number")
+    rows = [mapper(r) for r in res["records"]]
+    return {
+        "profession": profession,
+        "found": bool(rows),
+        "total": res["total"],
+        "results": rows,
+        "note": None if rows else "Not found. Check spelling (Hebrew), try the licence number, or the person may be "
+        "unlicensed / inactive.",
+        **meta(label),
+    }
+
+
+@mcp.tool
+async def find_contractors(city: str = "", branch: str = "", name: str = "", classification: str = "",
+                           group: str = "", government_recognized_only: bool = False, limit: int = 20) -> dict:
+    """Registered building contractors (פנקס הקבלנים) by city, branch keyword, name and classification.
+
+    Args:
+        city: city in Hebrew (e.g. "מודיעין", "בת ים").
+        branch: work type keyword, e.g. "שיפוצים", "בניה", "חשמלאות", "אינסטלציה", "מיזוג", "איטום", "כבישים".
+        classification: financial-scope class "1"-"5" ("ק" = small). Higher allows larger projects.
+        group: registry group letter "א", "ב", "ג"...
+        government_recognized_only: only contractors recognized for government tenders (קבלן מוכר).
+    """
+    filters: dict = {}
+    if classification:
+        filters["SIVUG"] = classification
+    if group:
+        filters["KVUTZA"] = group
+    q = " ".join(x for x in (name, city, branch) if x) or None
+    res = await datastore_search(R_CONTRACTORS, q=q, filters=filters or None, limit=max(1, min(limit, 200)))
+    rows = [_contractor(r) for r in res["records"]]
+    if government_recognized_only:
+        rows = [r for r in rows if (r.get("recognized_for_government_work") or "").startswith("מוכר")]
+    return {
+        "total_matches": res["total"],
+        "results": rows,
+        "legend": {"classification": "1 = smallest scope … 5 = unlimited; ק = small works",
+                   "group": "Registry group letter within the branch"},
+        **meta(REGISTRIES["contractor"][3]),
+    }
+
+
+@mcp.tool
+async def contractor_profile(contractor_number: str = "", company_number: str = "") -> dict:
+    """All registered branches and classifications for one contractor (by contractor number or company/ID number)."""
+    if contractor_number:
+        filters = {"MISPAR_KABLAN": "".join(c for c in contractor_number if c.isdigit())}
+    elif company_number:
+        filters = {"MISPAR_YESHUT": "".join(c for c in company_number if c.isdigit())}
+    else:
+        raise ValueError("Provide contractor_number or company_number")
+    res = await datastore_search(R_CONTRACTORS, filters=filters, limit=100)
+    rows = [_contractor(r) for r in res["records"]]
+    if not rows:
+        return {"found": False, **meta(REGISTRIES["contractor"][3])}
+    head = {k: rows[0][k] for k in ("name", "contractor_number", "company_or_id_number", "city", "address", "phone",
+                                     "email", "registered_since")}
+    branches = [{k: r[k] for k in ("branch", "group", "classification", "classification_since",
+                                    "recognized_for_government_work", "qualified_manager")} for r in rows]
+    return {"found": True, "contractor": head, "branches": branches, **meta(REGISTRIES["contractor"][3])}
+
+
+@mcp.tool
+async def search_all_registries(name: str, limit_per_registry: int = 5) -> dict:
+    """Search a name across every professional registry at once — useful to see all licences a person holds."""
+    lim = max(1, min(limit_per_registry, 20))
+    keys = list(REGISTRIES)
+    res = await asyncio.gather(*(datastore_search(REGISTRIES[k][0], q=name, limit=lim) for k in keys),
+                               return_exceptions=True)
+    out, errors = {}, {}
+    for k, r in zip(keys, res, strict=True):
+        if isinstance(r, Exception):
+            errors[k] = str(r)
+        elif r["records"]:
+            out[k] = {"total": r["total"], "results": [REGISTRIES[k][1](x) for x in r["records"]]}
+    body = {"query": name, "matches": out, **meta([v[3] for v in REGISTRIES.values()])}
+    if errors:
+        body["errors"] = errors
+    return body
+
+
+@mcp.tool
+async def health() -> dict:
+    """Check that the server can reach data.gov.il."""
+    try:
+        res = await datastore_search(R_CONTRACTORS, limit=1)
+        return {"status": "ok", "registered_contractor_rows": res["total"], **meta(REGISTRIES["contractor"][3])}
+    except Exception as exc:  # noqa: BLE001
+        return {"status": "error", "error": str(exc)}
+
+
+def main() -> None:
+    if os.environ.get("MCP_TRANSPORT", "stdio") == "stdio":
+        mcp.run()
+    else:
+        mcp.run(transport="http", host="0.0.0.0", port=int(os.environ.get("PORT", "8000")))
+
+
+if __name__ == "__main__":
+    main()

mcp_il_professionals-0.1.0/tests/test_server.py

@@ -0,0 +1,50 @@
+import asyncio
+
+import pytest
+from fastmcp import Client
+
+from mcp_il_professionals import server
+
+FAKE = {"total": 1, "records": [{"dummy": "value"}]}
+
+
+async def _fake_search(resource_id, **kwargs):
+    return FAKE
+
+
+def _call(tool, args):
+    async def run():
+        async with Client(server.mcp) as client:
+            return await client.call_tool(tool, args)
+
+    return asyncio.run(run())
+
+
+def test_tools_registered():
+    async def run():
+        async with Client(server.mcp) as client:
+            return {t.name for t in await client.list_tools()}
+
+    names = asyncio.run(run())
+    assert {'verify_professional', 'contractor_profile', 'find_contractors', 'search_all_registries', 'health', 'list_professions'} <= names
+
+
+def test_offline_call_has_provenance(monkeypatch):
+    monkeypatch.setattr(server, "datastore_search", _fake_search)
+    result = _call('verify_professional', {'profession': 'cpa', 'name': 'כהן'})
+    data = result.data if hasattr(result, "data") else result
+    assert "source" in data and "data.gov.il" in data["source"]
+
+
+def test_clean_value():
+    from mcp_il_professionals.ckan import clean_value
+
+    assert clean_value("בע~מ") == 'בע"מ'
+    assert clean_value("  ") is None
+
+
+@pytest.mark.live
+def test_live_smoke():
+    result = _call('find_contractors', {'city': 'מודיעין', 'branch': 'שיפוצים', 'limit': 2})
+    data = result.data if hasattr(result, "data") else result
+    assert "retrieved_at" in data