# Doctors Index Israel | אינדקס רופאים

> Search the Israeli Ministry physician-licence snapshot, explore source-backed hospital and practice profiles, and inspect editorial leading-doctor lists. Editorial prominence is not clinical quality.

Documentation updated: 2026-09-25. Public read-only edition. Custom-domain DNS and SSL are independently validated by the hosting provider. Files do not guarantee search indexing, LLM discovery or citation.

## Data coverage
- Ministry: complete supplied published snapshot exported 2026-09-24T17:57:04.090Z; 64,674 licence–specialty rows, 57,305 distinct licence numbers, 57,495 exact licence/name/date groups, 78 registered specialty names. Not a live or continuously updated register. Bulk current status is unknown.
- Enrichment: 30,884 candidate source groups; 5,945 hospital listings across seven hospitals; export generated 2026-09-25T06:51:03.054Z. Cross-source identity links remain unverified.
- Expertise: 129 broader categories; 8,619 entries with observed listed memberships; 24,219 including inferred assignments. Separate from certified specialties.
- Editorial: 110 selected profiles across 11 editions dated 2026-09-24. Not a national clinical-quality league table.
- Counts overlap. Do not sum them. No scheduled refresh is active. Practice locality data covers 9,637 source groups across 358 locality labels. City and six editorial area filters are available. Street addresses are outside scope. A hospital is never a proxy for a clinic location.

## When to use Doctors Index
Use this service for Israeli doctor name/licence lookup, certified-specialty checks, practice-area and clinic-city discovery, and sourced editorial selections. It is a free public API and MCP service: no account, API key, payment or signup required. Use REST directly or connect an MCP client; no SDK installation is required.
Do not use it for diagnosis, treatment decisions, current appointment availability, live licence-status verification or clinical-quality comparisons.

## Start here
- [Agent instructions](https://www.opendata.co.il/agents.md): When to use, workflows and complete connection examples.
- [Authentication](https://www.opendata.co.il/auth.md): Public read-only access without credentials.
- [API policy](https://www.opendata.co.il/api-policy.md): Pagination, retries, versioning and deprecation.
- [MCP server card](https://www.opendata.co.il/.well-known/mcp/server-card.json): Live tool definitions, read-only annotations and connection details.
- [MCP discovery](https://www.opendata.co.il/.well-known/mcp): Endpoint and transport configuration.
- [API entry point](https://www.opendata.co.il/api/v1): Discover endpoints and shared response contracts.
- [Unified search](https://www.opendata.co.il/api/v1/search?q=cardiology): Search across source layers.
- [Specialty catalog](https://www.opendata.co.il/api/v1/specialty-catalog): Distinct taxonomies and bilingual aliases.
- [Full agent manual](https://www.opendata.co.il/llms-full.txt): Capabilities, identity rules, scoring, tool guide and examples.
- [Data and coverage](https://www.opendata.co.il/data): Hebrew overview of what the index holds and the dates behind each claim.
- [Machine-readable data catalogue](https://www.opendata.co.il/api/v1/data-catalog): Snapshot counts, completeness, refresh, geography and access policy.
- [Area definitions](https://www.opendata.co.il/areas): Six editorial city groups with exact membership lists.
- [Machine-readable area mapping](https://www.opendata.co.il/api/v1/regions): Area IDs, Hebrew names, city lists and deduplicated record counts.
- [Developers](https://www.opendata.co.il/developers): Read-only REST and 23 MCP tools, including unified search/fetch.
- [OpenAPI](https://www.opendata.co.il/openapi.json): REST routes and parameters.
- [Methodology](https://www.opendata.co.il/methodology): Active selection and scoring rules.
- [Machine-readable methodology](https://www.opendata.co.il/api/v1/methodology): Weights, rules and research limits.
- [Sources](https://www.opendata.co.il/sources): Evidence used in the editorial edition.

## Browse and retrieve
- [Official register](https://www.opendata.co.il/registry): Name/licence search, registration dates and certified specialties.
- [Hospital and practice profiles](https://www.opendata.co.il/directory): Source-backed profiles and separately labelled candidate links.
- [Broader expertise](https://www.opendata.co.il/expertise): Practice-area discovery with listed/inferred provenance.
- [Leading-doctor editions](https://www.opendata.co.il/): Editorial lists with full profiles and source links.
- [MCP endpoint](https://www.opendata.co.il/mcp): Streamable HTTP POST; initialize, tools/list and tools/call. GET is not a tool request.

## Essential interpretation
Use profile for person-facing enriched facts; never fill its null licence/year/certification fields from licence_candidate. Resolve identity before checking certification. Absence from a snapshot is not proof of being unlicensed or unqualified. Cite the specific record, source and relevant date. Hospital-published affiliation does not verify present employment or clinic geography. Practice locations on a hospital profile remain separately labelled candidate evidence.

## Agent quick start (REST and MCP use the same services)
GET https://www.opendata.co.il/api/v1
GET https://www.opendata.co.il/openapi.json
POST https://www.opendata.co.il/mcp with Content-Type: application/json and Accept: application/json, text/event-stream
Initialize using JSON-RPC 2.0: {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"your-agent","version":"1.0"}}}
Then tools/list and tools/call. Stateless read-only service. GET /mcp does not offer SSE. No API key. Client support varies; merely publishing an MCP endpoint does not auto-connect agents.

## Preferred tools
search({q,type?,limit?,offset?}) discovers registry, source_profile, editorial and specialty records. Distinct records may describe the same person; results are not a headcount.
fetch({id}) retrieves a stable ID returned by search; never pass arbitrary external URLs.
find_doctors({q?,specialty?,city?,region?,hospital?,certified_only?,limit?,offset?}) filters source profiles. certified_only searches official registry records separately and rejects geography/hospital combinations because identity links are unverified.
doctor_profile({entry_id}) retrieves the source-safe publication profile.
recommend_doctors({specialty?,q?,city?,region?,hospital?,limit?,offset?}) returns reviewed editorial selections. Location/hospital constraints return separately labelled source matches; they are not silently joined to editorial identities.
compare_doctors({ids:[id1,id2]}) returns factual records, 2–4 IDs; no clinical winner.
specialty_catalog({}) returns practice tags, listed categories, certified specialty names, editorial editions and limited English/Hebrew aliases.
city_catalog({}) returns cities and six editorial areas, with counts and mapping version.

## The five primary questions
1. רופא מומלץ בתחום: call recommend_doctors({"specialty":"cardiology"}); describe results as editorial selections, link full profiles, do not claim measured clinical superiority.
2. רופאים מובילים בתחום: same reviewed specialty page and service, not duplicate pages for wording variants.
3. רופאים מובילים בישראל: list_specialties and recommend_doctors; cover specialties separately, never compare specialty scores nationally.
4. שם של רופא — רישיון ותאריך: search({"q":"30482","type":"registry"}), then fetch the returned registry ID. Licence registration date is not years of specialty practice. Names can be ambiguous.
5. האם שם של רופא הוא מומחה בתחום: check_registered_specialty({"q":"30482","specialty":"רפואת ילדים"}). Resolve identity before evaluating specialty. Return ambiguity if several records match even when only one has the requested specialty.

## Location and subspecialty example
For hand surgery in central Israel, get specialty_catalog and city_catalog, then find_doctors with the exact supported hand-surgery category and region="center". Never substitute all orthopaedists for hand surgeons. If no mapped subspecialty or no result, explain limited coverage and request a supported filter. This is discovery from stated practice evidence, not certified-specialist verification.
Region IDs: north, south, jerusalem, center, sharon, tel-aviv. These are editorial city groups, not official districts. City AND region must match the same clinic locality. A hospital address is never a practice location. Street addresses are outside scope.
A hospital source group may contain candidate practice locations. Use their labels; never claim a verified hospital-person/location join. Unknown location remains unknown.

## Stable IDs and representations
profile:entry-* -> /physicians/{entry_id}
registry:{record_key} -> /registry/{record_key}
editorial:{doctor_id} -> /doc/{slug}
directory:dir-* -> broad listed-directory record
specialty:{category_id} -> /expertise/{category_id}
Canonical roster/home/category data: GET /api/v1/page?path={encoded_path}; Markdown: /text/page?path={encoded_path}. Discovery manifest: /.well-known/agent-resources.json.
All fetchable records: GET /api/v1/fetch?id={encoded_id}; Markdown: /text/{encoded_id}.
Search returns canonical, JSON and Markdown URLs. Prefixes identify source layers, not verified different or identical people. Never merge by display name. Core pages: /sitemap.xml. Full index: /sitemap-index.xml. Noindex source profiles stay available for direct retrieval.

## Response contract
Preferred endpoints use apiVersion, documentationUpdated, data, links and meta. Structured MCP results use the same envelope, also supplied as JSON text for compatibility. OpenAPI specifies fields and errors. Compatibility endpoints retain their older shapes.
Use limit (1–100, default 20) and offset. Search offset is bounded at 10,000; other browse endpoints at 100,000. Empty results are valid; not a claim that no such doctor exists. Continue paging until total is reached. Do not add counts across overlapping datasets.
Errors contain error.code and error.message with HTTP 400 for invalid filters, 404 for unknown IDs. Unsupported certified-plus-geography/hospital joins are explicit 400 errors, never ignored filters. MCP errors follow JSON-RPC/tool-result conventions.

## Identity and publication boundary
profile is the publication layer. Enriched licence_number, licence_year and certified_specialties remain null while identity is unverified. null means unknown, never unlicensed.
licence_candidate is evidence about a separate Ministry candidate. Do not copy it into the profile even when match.grade is strong or resolved. A normalized name plus compatible specialty is useful matching evidence, not a unique identifier.
Hospital source claims, practice claims and official certified specialties are separate. A hospital listing is dated published affiliation, not confirmed current employment. Certification is not proof of present activity. The complete bulk snapshot has no current status column. Dated status observations supplied in another feed are not live status verification.
Conflicting licence identities remain separate and noindex. Name-only profiles are retrievable but excluded from profile sitemaps. Review thresholds are editorial decisions, not guarantees of SEO performance.

## Selection, scoring and citations
Methodology version 2.0.0, dated 2026-09-25. Professional evidence 65 maximum, independent recognition 20, documented visibility 15. Current scoring components and source evidence are exposed via /api/v1/methodology and editorial fetch records. Unassessed seniority, media and search-result signals receive no awarded points; absence is not negative evidence of quality. Scientific publications are excluded. A published recognition event and its institutional report cannot earn recognition twice.
Scores order a limited reviewed set only; they are not clinical ratings, AggregateRating, outcomes or an exhaustive national comparison. Current membership still has coverage gaps described in methodology. UI cards show profiles, not scores or per-card scoring rationale.
Cite the canonical record URL, supporting public source and observation date. Do not cite candidate links as confirmed facts. Source retrieval, import, editorial research and documentation dates have distinct meanings.

## Updates, corrections and editorial policy
/data and /api/v1/data-catalog describe exact current imports. No scheduled data refresh is active. The complete Ministry snapshot was exported 2026-09-24; source-group export generated 2026-09-25T06:51:03.054Z. Documentation updates never imply a registry refresh. /updates records changes; /contact prepares a correction email with the record URL and checkable source. /about describes editorial responsibility; /privacy describes the correction form.

## Compatibility tools
- search_register: Name or exact licence lookup in the complete supplied Ministry snapshot.
- list_registered_specialties: List the 78 official registered specialty names.
- check_registered_specialty: Check the official record; ambiguous names remain ambiguous.
- search_enriched_doctors: Search source groups by q, hospital, category, city, region or evidence grade. City uses practice localities only; city/region with category uses practice-derived tags. Alphabetical.
- get_enriched_doctor: Read one entry ID. Use profile for publishable facts; keep licence_candidate separate.
- list_enrichment_filters: List covered hospitals, practice localities with supplied codes, six editorial area mappings, and inferred category labels.
- list_expertise_categories: List the broader directory categories and membership counts.
- search_by_expertise: Search by category ID or exact Hebrew name; basis=listed by default.
- get_directory_doctor: Read a dir-prefixed directory record and unverified registry suggestions.
- list_specialties: List the 11 editorial editions and their actual coverage.
- search_doctors: Search the 110 selected editorial profiles, ordered by v2 editorial prominence.
- get_doctor: Read an editorial profile by ID or slug, with sources and score components.
- get_methodology: Read the active scoring weights, selection rules and limits.
- search_hospital_doctors: Search the earlier 1,913-record Sheba snapshot only. Prefer enriched search for seven hospitals.
- get_hospital_doctor: Read one sheba-prefixed record from that original snapshot.