# Israeli Doctors Database | מאגר הרופאים הישראלי

> Israeli physician lookup, certified specialties, accepted hospital and clinic enrichment, and editorial prominent-doctor selections. One canonical public profile per unambiguous Ministry licence identity.

## Coverage and dates
Registry snapshot: 2026-09-24. 64674 licence–specialty rows, 57305 distinct licence numbers. 57118 public profiles; 187 conflicting licence identities withheld. 11952 profiles have accepted enrichment; 3567 have clinic cities. These counts overlap; do not sum them. No automatic refresh is active. Documentation updated 2026-09-27.

## Start here
- [Agent instructions](https://www.docdb.co.il/agents.md)
- [Full manual](https://www.docdb.co.il/llms-full.txt)
- [OpenAPI](https://www.docdb.co.il/openapi.json)
- [API entry point](https://www.docdb.co.il/api/v1)
- [Data catalogue](https://www.docdb.co.il/api/v1/data-catalog)
- [MCP server card](https://www.docdb.co.il/.well-known/mcp/server-card.json)
- [MCP endpoint](https://www.docdb.co.il/api/v1/mcp): stateless Streamable HTTP POST, protocol 2025-03-26. Nine read-only tools. No authentication.
- [Authentication](https://www.docdb.co.il/auth.md)
- [API policy](https://www.docdb.co.il/api-policy.md)
- [Methodology](https://www.docdb.co.il/methodology)
- [Doctor search](https://www.docdb.co.il/doctors)
- [Certified specialties](https://www.docdb.co.il/fields)
- [Clinic cities](https://www.docdb.co.il/cities)
- [Six clinic regions](https://www.docdb.co.il/areas)
- [Sitemap index](https://www.docdb.co.il/sitemap-index.xml)

## Interpretation
Licence details and certified specialties come from the Ministry. Hospital and practice data are independently matched using unique full name and explicit specialty support, with conflicts withheld. These are rule-accepted links, not independently verified identities or certainty guarantees. Ambiguous source records stay private. Status observations have their own dates; unknown status never means unlicensed. Hospital affiliation is not clinic geography. Editorial prominence is not clinical quality. Cite each canonical profile, evidence and relevant date.

## REST workflows
GET https://www.docdb.co.il/api/v1/search?q=cardiology&limit=5
GET https://www.docdb.co.il/api/v1/fetch?id=doctor:26310
GET https://www.docdb.co.il/api/v1/find?specialty=hand-surgery&region=center
GET https://www.docdb.co.il/api/v1/recommendations?specialty=urology
GET https://www.docdb.co.il/api/v1/registry/check-specialty?q=26310&specialty=%D7%90%D7%A0%D7%98%D7%95%D7%9E%D7%99%D7%94%20%D7%A4%D7%AA%D7%95%D7%9C%D7%95%D7%92%D7%99%D7%AA
GET https://www.docdb.co.il/api/v1/specialty-catalog
GET https://www.docdb.co.il/api/v1/city-catalog
GET https://www.docdb.co.il/api/v1/compare?ids=doctor:26310,doctor:19096

Search -> choose an unambiguous returned ID -> fetch -> cite. Name ambiguity must be resolved before checking specialty. Do not narrow identity candidates by requested specialty. No result is not proof that a doctor is unlicensed or unavailable.

## Nine MCP tools
search({q,limit?,offset?})
fetch({id})
find_doctors({q?,specialty?,city?,region?,hospital?,hospital_employed?,certified_only?,limit?,offset?})
doctor_profile({entry_id})
recommend_doctors({q?,specialty?,city?,region?,hospital?,hospital_employed?,limit?,offset?})
compare_doctors({ids:[id1,id2]})
specialty_catalog({})
city_catalog({})
check_registered_specialty({q,specialty})

POST https://www.docdb.co.il/api/v1/mcp with Content-Type: application/json and Accept: application/json, text/event-stream.
Initialize: {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"directory-client","version":"1.0"}}}
Then notifications/initialized, tools/list, tools/call. Stateless JSON responses, no standalone SSE stream; GET returns 405. No API key, SDK or signup. Publishing a server does not automatically connect agents.

## One identity and multiple representations
Canonical ID doctor:{licence}; HTML /doctors/{licence}; JSON /api/v1/fetch?id=doctor:{licence}; Markdown /text/doctor:{licence}. Accepted legacy profile, registry and editorial IDs resolve to the same identity; unresolved source-only IDs return 404. Separate source-layer search results and tools were removed in API version 3.
Page JSON: /api/v1/page?path=/doctors/{licence}; Markdown: /text/page?path=/doctors/{licence}. REST and MCP use the same service functions. Responses include apiVersion, documentationUpdated, data, links, meta. Error bodies include error.code and error.message. Invalid queries return 400; missing profiles 404. Limits 1–100 (default 20), offset 0–100000. Empty results are valid. No implied clinical winner in comparisons.

## Fields and geography
certified_specialties and specialty_registrations are Ministry fields. licence_registered_on is the general registration date; it is not the specialty qualification date. licence_status is a dated separate observation or null. practice_expertise is separately sourced. hospitals contain role, department, source URL and evidence dates. Clinic sources remain internal; their match method, dates and accepted evidence type are provided.
Cities refer only to clinics. Areas: north, south, jerusalem, center, sharon, tel-aviv. They are our city grouping, not official districts. City plus region must match the same clinic locality. Unknown locality is never inferred from a hospital. hospital_employed=true selects accepted dated hospital staff listings; it does not prove present employment. Specialty filters use official certification. Hand surgery never expands to all orthopaedics.

## Editorial selections
For the 11 editorial specialty pages, the numbered featured table and recommendations API use the same order and require a documented leadership role or published recognition relevant to that registered specialty. The first four profiles appear in the page introduction.
Profiles qualify for featured selection through an accepted hospital leadership listing or a matched published recognition record. Ordering uses documented hospital listing (15), leadership (20), explicit institutional professor title (10), published recognition (25), and licence age (one per five years, capped at 10). Maximum 80. Missing evidence earns no points, not a negative quality assessment. Scientific publications, patient reviews and media volume are excluded. Scores describe evidence-based prominence within the covered set; not medical quality, outcomes, or national superiority. Read /api/v1/methodology.

## Identity checks and corrections
Original source full-name tokens must match uniquely across the registry, and explicit specialty must agree. No fuzzy or partial matches. Hospital and clinic sources are matched independently against all registry identities. Aggregate supplied strong/resolved labels do not authorize a link. Conflicting licence identities, duplicate source observations and missing original source names are held privately. Rule acceptance is not a measured zero-error rate.
All source dates remain distinct from import and documentation dates. Hospital listing is dated affiliation evidence, not confirmed current employment. Corrections: /contact. Coverage: /data. Migration notes: /updates.