From 66709222b279e4119c623b9ebc292e7aeb9bcd9c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc-Andr=C3=A9=20Bombeck?= Date: Tue, 3 Nov 2026 21:33:18 +0100 Subject: [PATCH] docs(api): describe the lab reading id next to the analyte id --- docs/api/mcp-capabilities.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/api/mcp-capabilities.md b/docs/api/mcp-capabilities.md index 0d65f025e..99e09d612 100644 --- a/docs/api/mcp-capabilities.md +++ b/docs/api/mcp-capabilities.md @@ -110,6 +110,14 @@ What `search` matches for the clinical records: reading deferred is matched on its title and details only. - `vaccination:`: vaccine name, catalogue name, practitioner. +A lab has two ids. `lab:` is the analyte view and answers with that +marker's latest reading. `labresult:` is one reading: its value or text +result, unit, reference range, status, date, and its own links (the report +it was read from, the visits it is filed against). Every link to a lab result +(from a document, a visit, a condition or a medication) uses the reading id, +so following a report's link lands on the reading that report holds rather +than on a later draw. Each reading in `get_labs` carries the same id. + Condition and vaccination notes are never searched or returned, the same rule the Coach and the doctor report follow. A deleted practitioner is not named or matched. Query words shorter than four letters match whole words or