oth-mcp 0.1.3 → 0.1.5

package/README.md

@@ -13,12 +13,15 @@ The server is designed for minimal token usage. Instead of embedding the full AP
 
 ## Setup
 
+**Defaults with no env set:** `OTH_ENV=dev` → base URL `https://doccla-dev.oth.io`, credentials read from Keychain account `oth-dev`. Override `OTH_ENV` (`dev`, `stag`, `demo`, `local`) to target another environment — the Keychain account name follows as `oth-<env>`.
+
 ### 1. Configure credentials
 
 **macOS Keychain (preferred)** — no plaintext on disk:
 
 ```bash
-# For each environment (oth-dev, oth-stag, oth-demo):
+# Account name is oth-<env>, so repeat per env you use
+# (oth-dev, oth-stag, oth-demo, oth-local):
 security add-generic-password -a "oth-dev" -s "oth-mcp-username" -w
 security add-generic-password -a "oth-dev" -s "oth-mcp-password" -w
 ```
@@ -31,12 +34,47 @@ export OTH_PASSWORD="your-password"
 export OTH_ENV="dev"  # optional, defaults to dev
 ```
 
-### 2. Add to Claude Code
+### 2. Add to Claude Code (no env default dev)
 
 ```bash
 claude mcp add oth -- npx -y oth-mcp
 ```
 
+Pass env vars with `-e KEY=VALUE` (repeatable). Example pointing at a local opentele stack with inline creds:
+
+```bash
+claude mcp add oth \
+  -e OTH_ENV=local \
+  -e OTH_USERNAME=admin \
+  -e OTH_PASSWORD=admin_23 \
+  -- npx -y oth-mcp
+```
+
+Omit `OTH_USERNAME`/`OTH_PASSWORD` if you've stored them in Keychain under `oth-local`. Use `-e OTH_BASE_URL=http://host.docker.internal:7100` if the default `http://localhost:7100` isn't reachable.
+
+### Local OTH (docker)
+
+To point the MCP at a local opentele stack run via docker:
+
+```bash
+# in the opentele repo:
+cd dev && docker compose up -d --wait
+
+# then launch the MCP with:
+export OTH_ENV=local          # → http://localhost:7100
+export OTH_USERNAME=admin
+export OTH_PASSWORD=admin_23  # or any dev account — see opentele docs
+```
+
+Or store local creds in Keychain under the `oth-local` account:
+
+```bash
+security add-generic-password -a "oth-local" -s "oth-mcp-username" -w
+security add-generic-password -a "oth-local" -s "oth-mcp-password" -w
+```
+
+Set `OTH_BASE_URL` to override the host/port (e.g. `http://host.docker.internal:7100`) if you're not on the default.
+
 ## Tools
 
 ### `oth_get`

package/dist/api-guide.d.ts

@@ -1 +1 @@
-export declare const API_GUIDE = "# OTH API Endpoint Reference\n\n## Key Concepts\n\nLinks are the API's primary navigation mechanism. Every response includes a\nlinks object with absolute URIs. Use these as-is for subsequent requests \u2014\nnever construct URLs from IDs manually. Foreign key references (e.g. patient\nin a measurement, patientGroups in a patient) are always link URIs, not bare IDs.\n\nAuth: the MCP server handles auth transparently. For reference, most read\nendpoints and questionnaire submission accept Basic auth. Acknowledgements,\nignored, and manual measurement-captures require a clinician-scoped Bearer JWT\nobtained via POST /idp2/tokens.\n\n## Common Workflows\n\nReview results:\n  GET /clinician/api/patients?uniqueId={nhsNo}\n  GET /results/results?patient={patient-link}&acknowledged=false\n  GET {result-link}\n  PUT {result-link}/acknowledgement  (Bearer JWT required)\n\nSubmit questionnaire response:\n  GET /clinician/api/questionnaire_definitions/{id}\n  GET {links.activeQuestionnaire}  (extract node names from response)\n  POST {questionnaire-link}/results\n    {version:\"1.0\", date:ISO-8601, links:{patient:uri},\n     output:[{name:\"{nodeName}.FIELD\", type:\"Integer\"|\"Float\"|\"Object\"|\"Boolean\", value:<typed>}]}\n\nSubmit measurement (clinician-entered):\n  POST /measurements/measurement-captures\n    {source, sourceId, captureTime, links:{patient:uri},\n     measurements:[{type, timestamp, measurement:{<type-specific>},\n       origin:{manualMeasurement:{enteredBy} | deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier}}}]}\n  Common types: blood_pressure({systolic,diastolic,unit}), pulse({value,unit}),\n    saturation({value,unit}), temperature({value,unit}), weight(Float)\n\nPatient lifecycle:\n  POST /clinician/api/patients  (with links.patientGroups)\n  GET+PUT /organizations/patients/{id}/metadata  (PUT replaces entire set \u2014 GET first, merge, then PUT)\n  PUT /clinician/api/patients/{id}  (status:\"discharged\")\n\n## Patients\nGET /clinician/api/patients                     ?uniqueId= &username= &firstName= &lastName= &search= &phone= &patientGroup= &id= &status= &select= &max= &offset=\nGET /clinician/api/patients/{id}\nGET /clinician/api/patients/me\nGET /clinician/api/patients/{id}/measurements           ?from= &to= &max=\nGET /clinician/api/patients/{id}/measurements/aggregate\nGET /clinician/api/patients/{id}/measurement-types\nGET /clinician/api/patients/{id}/questionnaires\nGET /clinician/api/patients/{id}/questionnaire_schedules\nPOST /clinician/api/patients/{id}/questionnaire_schedules\nGET /clinician/api/patients/{id}/contact-info\nPUT /clinician/api/patients/{id}/contact-info\nGET /clinician/api/patients/{id}/acknowledgements\n  status enum: all|active|inactive|discharged|discharged_self_managed|deceased (default: active)\n  patientGroup and id are repeatable (up to 100\u00D7) for batch queries\n  search matches across firstName, lastName, uniqueId, username\n\n## Clinicians\nGET /clinician/api/clinicians                    ?max= &offset=\nPOST /clinician/api/clinicians\nGET /clinician/api/clinicians/{id}\nPUT /clinician/api/clinicians/{id}\nGET /clinician/api/clinicians/me\nGET /clinician/api/clinicians/me/colleagues\n\n## Questionnaire Definitions\nGET /clinician/api/questionnaire_definitions     ?max= &offset=\nGET /clinician/api/questionnaire_definitions/{id}\nPOST /clinician/api/questionnaire_definitions    {name, requiresManualInspection}\nPUT /clinician/api/questionnaire_definitions/{id}\n\n## Questionnaires (node graph)\nGET /clinician/api/questionnaires/{id}\nPOST /clinician/api/questionnaires/{id}/results\n\n## Results\nGET /results/results                             ?patient= &acknowledged= &resultType= &questionnaire= &order= &from= &to= &max=\nGET /results/results/{uuid}\nPUT /results/results/{uuid}/acknowledgement      (Bearer JWT required)\nPUT /results/results/{uuid}/ignored              (Bearer JWT required)\n\n## Questionnaire Schedules\nGET /clinician/api/questionnaire_schedules       ?max= &offset=\n\n## Questionnaire Groups\nGET /questionnaires/questionnaire-groups         ?max=\nPOST /questionnaires/questionnaire-groups        {name, questionnaireDefinitions}\n\n## Patient Notes\nGET /clinician/api/patient-notes                 ?max= &offset=\nPOST /clinician/api/patient-notes\nGET /clinician/api/patient-notes/{id}\nPUT /clinician/api/patient-notes/{id}\nDELETE /clinician/api/patient-notes/{id}\nPOST /clinician/api/patient-notes/{id}/read\n\n## Measurements\nGET /measurements/measurement-types\nGET /measurements/measurement-captures           ?patient= &source= &since= &from= &to= &max=\nPOST /measurements/measurement-captures\nGET /measurements/measurement-captures/{uuid}\nPOST /measurements/measurement-captures/{uuid}/measurements\nGET /measurements/measurement-streams            ?patient= &patientGroup= &from= &to= &max=\nPOST /measurements/measurement-streams\nGET /measurements/measurement-streams/{uuid}\nGET /measurements/measurement-streams/{uuid}/measurements\nGET /measurements/measurement-streams/{uuid}/incidents\nGET /measurements/measurement-streams/incidents\nPOST /measurements/measurement-streams/acknowledgements\nGET /measurements/processors\nGET /measurements/processors/{name}\n\n## Thresholds\nGET /thresholds/patient-thresholds               ?patient= &max=\nPOST /thresholds/patient-thresholds\nGET /thresholds/patient-thresholds/{uuid}\nPUT /thresholds/patient-thresholds/{uuid}\nDELETE /thresholds/patient-thresholds/{uuid}\nGET /thresholds/patient-group-thresholds         ?max=\nPOST /thresholds/patient-group-thresholds\nGET /thresholds/patient-group-thresholds/{uuid}\nPUT /thresholds/patient-group-thresholds/{uuid}\nDELETE /thresholds/patient-group-thresholds/{uuid}\nPOST /thresholds/evaluation\n\n## Organizations\nGET /organizations/organizations\nGET /organizations/organizations/{uuid}\nPUT /organizations/organizations/{uuid}\nGET /organizations/organizations/{uuid}/metadata-fields\nGET /organizations/patients/{id}/metadata\nPUT /organizations/patients/{id}/metadata         (replaces entire set \u2014 GET first, merge, then PUT)\n\n## Object Storage\nPOST /object-storage/objects                      (raw body, set Content-Type header)\nGET /object-storage/objects/{uuid}\n\n## Users & IDP\nPOST /idp2/tokens                                (Basic auth, body: {links:{clinician:uri}}) \u2192 201 {token}\nGET /idp2/users/{id}\nPUT /idp2/users/{id}/locked\nDELETE /idp2/users/{id}/password\nGET /idp2/roles\nGET /idp2/permissions\n\n## Patient Groups\nGET /clinician/api/patientgroups                 ?max= &offset=\nGET /clinician/api/patientgroups/{id}\nPOST /clinician/api/patientgroups\nPUT /clinician/api/patientgroups/{id}\nDELETE /clinician/api/patientgroups/{id}\n\n## Audit\nGET /audit/resources/{resourceUrl}               ?max= &offset=\n\n## Calendar\nGET /calendar/events                             ?patient= &from= &to=\nPOST /calendar/events\nGET /calendar/events/{uuid}\nPUT /calendar/events/{uuid}\nDELETE /calendar/events/{uuid}\n\n## Chat\nGET /chat/threads                                ?patient=\nGET /chat/threads/{uuid}\nGET /chat/threads/{uuid}/messages\nPOST /chat/threads/{uuid}/read\nPOST /chat/messages\nGET /chat/messages/{uuid}\nPOST /chat/messages/{uuid}/read\nGET /chat/snippets\nPOST /chat/snippets\nPUT /chat/snippets/{uuid}\nDELETE /chat/snippets/{uuid}\n\n## Notifications\nGET /notifications/devices                       ?user=\nPOST /notifications/devices\nGET /notifications/subscriptions\nPOST /notifications/subscriptions\nDELETE /notifications/subscriptions/{uuid}\n\n## Mutation Request Bodies\n\nPOST /clinician/api/patients\n  required: uniqueId, username, firstName, lastName, sex(male|female|unknown),\n            address, postalCode, city, links.patientGroups[uri...]\n  optional: dateOfBirth(YYYY-MM-DD), phone, mobilePhone, email, comment,\n            dueDate, profilePicture, place, relatives[{firstName,lastName,relation,phone}]\n\nPUT /clinician/api/patients/{id}\n  required: uniqueId, username, firstName, lastName, sex, address, postalCode, city,\n            status(active|inactive|discharged|discharged_self_managed|deceased),\n            links.patientGroups[uri...]\n  optional: dateOfBirth, phone, mobilePhone, email, comment, dueDate, profilePicture,\n            place, relatives[{firstName,lastName,relation,phone}]\n\nPOST /clinician/api/clinicians\n  required: username, firstName, lastName, links.patientGroups[uri...], links.roles[uri...]\n  optional: email, phone, mobilePhone, uniqueId\n\nPOST /clinician/api/patient-notes\n  required: note, type(normal|important), links.patient(uri)\n  optional: reminderDate(date-time)\n\nPOST /clinician/api/patientgroups\n  required: name, messagingEnabled, blueAlarmsEnabled, links.organization(uri)\n  optional: dueDateVisible, calculateBloodPressureWeeklyAverage, copdPrediction\n\nPOST /clinician/api/patients/{id}/questionnaire_schedules\n  required: links.questionnaireDefinition(uri)\n  optional: scheduledTime (varies by type \u2014 WEEKDAYS, MONTHLY, EVERY_NTH_DAY, SPECIFIC_DATE, etc.)\n\nPOST /measurements/measurement-captures\n  required: source, sourceId, captureTime(date-time), links.patient(uri),\n            measurements[{type, timestamp, measurement:{<type-specific fields>},\n              origin:{manualMeasurement:{enteredBy} | deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier}}}]\n  optional: historic\n  note: source+sourceId must be unique per capture\n\nPOST /measurements/measurement-streams\n  required: inputType(e.g. \"discrete\"), links.patient(uri),\n            measurements[{type, timestamp, measurement:{value,unit},\n              origin:{deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier:{macAddress}}}}]\n\nPUT /results/results/{uuid}/acknowledgement\n  required: note, date(date-time), visibleForPatient(bool)\n  optional: closureNotes[string...]\n\nPUT /results/results/{uuid}/ignored\n  required: replyIds[string...]  (empty array to unignore)\n  optional: reason\n\nPOST /chat/messages\n  required: body, links.organization(uri)\n  variant 1: links.patient(uri), optional links.attachments[uri...]\n  variant 2: links.patientGroup(uri)\n\nPOST /calendar/events\n  required: type, description, schedule.startTime(date-time),\n            party.clinicians[{links.clinician(uri)}],\n            party.patients[{links.patient(uri)}],\n            links.origin(uri)\n  optional: schedule.endTime(date-time), party.name\n\n## Notes\n- Dates use ISO 8601: 2024-01-01T00:00:00.000Z\n- Default max is 100, default offset is 0\n- All list endpoints support pagination via max/offset\n- Clinician-service resources use numeric {id}; other services use {uuid}\n- Links are always absolute URIs: https://doccla-dev.oth.io/clinician/api/patients/123\n- Schemas discoverable via each service's root links.schemas; filenames vary by endpoint\n";
+export declare const API_GUIDE = "# OTH API Endpoint Reference\n\n## Key Concepts\n\nLinks are the API's primary navigation mechanism. Every response includes a\nlinks object with absolute URIs. Use these as-is for subsequent requests \u2014\nnever construct URLs from IDs manually. Foreign key references (e.g. patient\nin a measurement, patientGroups in a patient) are always link URIs, not bare IDs.\n\nAuth: the MCP server handles auth transparently. For reference, most read\nendpoints and questionnaire submission accept Basic auth. Acknowledgements,\nignored, and manual measurement-captures require a clinician-scoped Bearer JWT\nobtained via POST /idp2/tokens.\n\n## Common Workflows\n\nReview results:\n  GET /clinician/api/patients?uniqueId={nhsNo}\n  GET /results/results?patient={patient-link}&acknowledged=false\n  GET {result-link}\n  PUT {result-link}/acknowledgement  (Bearer JWT required)\n\nSubmit questionnaire response:\n  GET /clinician/api/questionnaire_definitions/{id}\n  GET {links.activeQuestionnaire}  (extract node names from response)\n  POST {questionnaire-link}/results\n    {version:\"1.0\", date:ISO-8601, links:{patient:uri},\n     output:[{name:\"{nodeName}.FIELD\", type:\"Integer\"|\"Float\"|\"Object\"|\"Boolean\", value:<typed>}]}\n\nSubmit measurement (clinician-entered):\n  POST /measurements/measurement-captures\n    {source, sourceId, captureTime, links:{patient:uri},\n     measurements:[{type, timestamp, measurement:{<type-specific>},\n       origin:{manualMeasurement:{enteredBy} | deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier}}}]}\n  Common types: blood_pressure({systolic,diastolic,unit}), pulse({value,unit}),\n    saturation({value,unit}), temperature({value,unit}), weight(Float)\n\nPatient lifecycle:\n  POST /clinician/api/patients  (with links.patientGroups)\n  GET+PUT /organizations/patients/{id}/metadata  (PUT replaces entire set \u2014 GET first, merge, then PUT)\n  PUT /clinician/api/patients/{id}  (status:\"discharged\")\n\n## Patients\nGET /clinician/api/patients                     ?uniqueId= &username= &firstName= &lastName= &search= &phone= &patientGroup= &id= &status= &select= &max= &offset=\nGET /clinician/api/patients/{id}\nGET /clinician/api/patients/me\nGET /clinician/api/patients/{id}/measurements           ?from= &to= &max=\nGET /clinician/api/patients/{id}/measurements/aggregate\nGET /clinician/api/patients/{id}/measurement-types\nGET /clinician/api/patients/{id}/questionnaires\nGET /clinician/api/patients/{id}/questionnaire_schedules\nPOST /clinician/api/patients/{id}/questionnaire_schedules\nGET /clinician/api/patients/{id}/contact-info\nPUT /clinician/api/patients/{id}/contact-info\nGET /clinician/api/patients/{id}/acknowledgements\n  status enum: all|active|inactive|discharged|discharged_self_managed|deceased (default: active)\n  patientGroup and id are repeatable (up to 100\u00D7) for batch queries\n  search matches across firstName, lastName, uniqueId, username\n\n## Clinicians\nGET /clinician/api/clinicians                    ?max= &offset=\nPOST /clinician/api/clinicians\nGET /clinician/api/clinicians/{id}\nPUT /clinician/api/clinicians/{id}\nGET /clinician/api/clinicians/me\nGET /clinician/api/clinicians/me/colleagues\n\n## Questionnaire Definitions\nGET /clinician/api/questionnaire_definitions     ?max= &offset=\nGET /clinician/api/questionnaire_definitions/{id}\nPOST /clinician/api/questionnaire_definitions    {name, requiresManualInspection}\nPUT /clinician/api/questionnaire_definitions/{id}\n\n## Questionnaires (node graph)\nGET /clinician/api/questionnaires/{id}\nPOST /clinician/api/questionnaires/{id}/results\n\n## Results\nGET /results/results                             ?patient= &acknowledged= &resultType= &questionnaire= &order= &from= &to= &max=\nGET /results/results/{uuid}\nPUT /results/results/{uuid}/acknowledgement      (Bearer JWT required)\nPUT /results/results/{uuid}/ignored              (Bearer JWT required)\n\n## Questionnaire Schedules\nGET /clinician/api/questionnaire_schedules       ?max= &offset=\n\n## Questionnaire Groups\nGET /questionnaires/questionnaire-groups         ?max=\nPOST /questionnaires/questionnaire-groups        {name, questionnaireDefinitions}\n\n## Patient Notes\nGET /clinician/api/patient-notes                 ?max= &offset=\nPOST /clinician/api/patient-notes\nGET /clinician/api/patient-notes/{id}\nPUT /clinician/api/patient-notes/{id}\nDELETE /clinician/api/patient-notes/{id}\nPOST /clinician/api/patient-notes/{id}/read\n\n## Measurements\nGET /measurements/measurement-types\nGET /measurements/measurement-captures           ?patient= &source= &since= &from= &to= &max=\nPOST /measurements/measurement-captures\nGET /measurements/measurement-captures/{uuid}\nPOST /measurements/measurement-captures/{uuid}/measurements\nGET /measurements/measurement-streams            ?patient= &patientGroup= &from= &to= &max=\nPOST /measurements/measurement-streams\nGET /measurements/measurement-streams/{uuid}\nGET /measurements/measurement-streams/{uuid}/measurements\nGET /measurements/measurement-streams/{uuid}/incidents\nGET /measurements/measurement-streams/incidents\nPOST /measurements/measurement-streams/acknowledgements\nGET /measurements/processors\nGET /measurements/processors/{name}\n\n## Thresholds\nGET /thresholds/patient-thresholds               ?patient= &max=\nPOST /thresholds/patient-thresholds\nGET /thresholds/patient-thresholds/{uuid}\nPUT /thresholds/patient-thresholds/{uuid}\nDELETE /thresholds/patient-thresholds/{uuid}\nGET /thresholds/patient-group-thresholds         ?max=\nPOST /thresholds/patient-group-thresholds\nGET /thresholds/patient-group-thresholds/{uuid}\nPUT /thresholds/patient-group-thresholds/{uuid}\nDELETE /thresholds/patient-group-thresholds/{uuid}\nPOST /thresholds/evaluation\n\n## Organizations\nGET /organizations/organizations\nGET /organizations/organizations/{uuid}\nPUT /organizations/organizations/{uuid}\nGET /organizations/organizations/{uuid}/metadata-fields\nGET /organizations/patients/{id}/metadata\nPUT /organizations/patients/{id}/metadata         (replaces entire set \u2014 GET first, merge, then PUT)\n\n## Object Storage\nPOST /object-storage/objects                      (raw body, set Content-Type header)\nGET /object-storage/objects/{uuid}\n\n## Users & IDP\nPOST /idp2/tokens                                (Basic auth, body: {links:{clinician:uri}}) \u2192 201 {token}\nGET /idp2/users/{id}\nPUT /idp2/users/{id}/locked\nDELETE /idp2/users/{id}/password\nGET /idp2/roles\nGET /idp2/permissions\n\n## Patient Groups\nGET /clinician/api/patientgroups                 ?max= &offset=\nGET /clinician/api/patientgroups/{id}\nPOST /clinician/api/patientgroups\nPUT /clinician/api/patientgroups/{id}\nDELETE /clinician/api/patientgroups/{id}\n\n## Audit\nGET /audit/resources/{resourceUrl}               ?max= &offset=\n\n## Calendar\nGET /calendar/events                             ?patient= &from= &to=\nPOST /calendar/events\nGET /calendar/events/{uuid}\nPUT /calendar/events/{uuid}\nDELETE /calendar/events/{uuid}\n\n## Chat\nGET /chat/threads                                ?patient=\nGET /chat/threads/{uuid}\nGET /chat/threads/{uuid}/messages\nPOST /chat/threads/{uuid}/read\nPOST /chat/messages\nGET /chat/messages/{uuid}\nPOST /chat/messages/{uuid}/read\nGET /chat/snippets\nPOST /chat/snippets\nPUT /chat/snippets/{uuid}\nDELETE /chat/snippets/{uuid}\n\n## Notifications\nGET /notifications/devices                       ?user=\nPOST /notifications/devices\nGET /notifications/subscriptions\nPOST /notifications/subscriptions\nDELETE /notifications/subscriptions/{uuid}\n\n## Mutation Request Bodies\n\nPOST /clinician/api/patients\n  required: uniqueId, username, firstName, lastName, sex(male|female|unknown),\n            address, postalCode, city, links.patientGroups[uri...]\n  optional: dateOfBirth(YYYY-MM-DD), phone, mobilePhone, email, comment,\n            dueDate, profilePicture, place, relatives[{firstName,lastName,relation,phone}]\n\nPUT /clinician/api/patients/{id}\n  required: uniqueId, username, firstName, lastName, sex, address, postalCode, city,\n            status(active|inactive|discharged|discharged_self_managed|deceased),\n            links.patientGroups[uri...]\n  optional: dateOfBirth, phone, mobilePhone, email, comment, dueDate, profilePicture,\n            place, relatives[{firstName,lastName,relation,phone}]\n  note: PUT shape differs from GET \u2014 GET returns patientGroups as nested objects and\n        links with all navigation URIs; PUT expects only links.patientGroups as a flat\n        array of URIs. Omit fields rather than sending null \u2014 some null values are\n        stored as the string \"null\". uniqueId must be unique across the system;\n        duplicates return 422 \"Patient not replaced\".\n\nPOST /clinician/api/clinicians\n  required: username, firstName, lastName, links.patientGroups[uri...], links.roles[uri...]\n  optional: email, phone, mobilePhone, uniqueId\n\nPOST /clinician/api/patient-notes\n  required: note, type(normal|important), links.patient(uri)\n  optional: reminderDate(date-time)\n\nPOST /clinician/api/patientgroups\n  required: name, messagingEnabled, blueAlarmsEnabled, links.organization(uri)\n  optional: dueDateVisible, calculateBloodPressureWeeklyAverage, copdPrediction\n\nPOST /clinician/api/patients/{id}/questionnaire_schedules\n  required: links.questionnaireDefinition(uri)\n  optional: scheduledTime (varies by type \u2014 WEEKDAYS, MONTHLY, EVERY_NTH_DAY, SPECIFIC_DATE, etc.)\n\nPOST /measurements/measurement-captures\n  required: source, sourceId, captureTime(date-time), links.patient(uri),\n            measurements[{type, timestamp, measurement:{<type-specific fields>},\n              origin:{manualMeasurement:{enteredBy} | deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier}}}]\n  optional: historic\n  note: source+sourceId must be unique per capture\n\nPOST /measurements/measurement-streams\n  required: inputType(e.g. \"discrete\"), links.patient(uri),\n            measurements[{type, timestamp, measurement:{value,unit},\n              origin:{deviceMeasurement:{connectionType,manufacturer,model,primaryDeviceIdentifier:{macAddress}}}}]\n\nPUT /results/results/{uuid}/acknowledgement\n  required: note, date(date-time), visibleForPatient(bool)\n  optional: closureNotes[string...]\n\nPUT /results/results/{uuid}/ignored\n  required: replyIds[string...]  (empty array to unignore)\n  optional: reason\n\nPOST /chat/messages\n  required: body, links.organization(uri)\n  variant 1: links.patient(uri), optional links.attachments[uri...]\n  variant 2: links.patientGroup(uri)\n\nPOST /calendar/events\n  required: type, description, schedule.startTime(date-time),\n            party.clinicians[{links.clinician(uri)}],\n            party.patients[{links.patient(uri)}],\n            links.origin(uri)\n  optional: schedule.endTime(date-time), party.name\n\n## Notes\n- Dates use ISO 8601: 2024-01-01T00:00:00.000Z\n- Default max is 100, default offset is 0\n- All list endpoints support pagination via max/offset\n- Clinician-service resources use numeric {id}; other services use {uuid}\n- Links are always absolute URIs: https://doccla-dev.oth.io/clinician/api/patients/123\n- Schemas discoverable via each service's root links.schemas; filenames vary by endpoint\n";

package/dist/api-guide.js

@@ -196,6 +196,11 @@ PUT /clinician/api/patients/{id}
             links.patientGroups[uri...]
   optional: dateOfBirth, phone, mobilePhone, email, comment, dueDate, profilePicture,
             place, relatives[{firstName,lastName,relation,phone}]
+  note: PUT shape differs from GET — GET returns patientGroups as nested objects and
+        links with all navigation URIs; PUT expects only links.patientGroups as a flat
+        array of URIs. Omit fields rather than sending null — some null values are
+        stored as the string "null". uniqueId must be unique across the system;
+        duplicates return 422 "Patient not replaced".
 
 POST /clinician/api/clinicians
   required: username, firstName, lastName, links.patientGroups[uri...], links.roles[uri...]

package/dist/auth.js

@@ -1,8 +1,11 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
+const ENV_URLS = {
+    local: "http://localhost:7100",
+};
 function envBaseUrl(env) {
-    return `https://doccla-${env}.oth.io`;
+    return ENV_URLS[env] ?? `https://doccla-${env}.oth.io`;
 }
 const REFRESH_BUFFER_SECONDS = 60;
 const AUTH_ERROR_MESSAGES = {
@@ -27,7 +30,7 @@ export class AuthManager {
         return this.env;
     }
     get baseUrl() {
-        return envBaseUrl(this.env);
+        return process.env.OTH_BASE_URL ?? envBaseUrl(this.env);
     }
     get isAuthenticated() {
         return this.state !== null;

package/dist/tools.js

@@ -133,9 +133,9 @@ Read the oth://api-guide resource for full endpoint reference.`,
         },
         inputSchema: {
             environment: z
-                .enum(["dev", "stag", "demo"])
+                .enum(["dev", "stag", "demo", "local"])
                 .optional()
-                .describe("Target environment. Omit to show current state."),
+                .describe("Target environment. Omit to show current state. 'local' targets http://localhost:7100 (opentele docker stack); set OTH_BASE_URL to override."),
         },
     }, async ({ environment }) => {
         if (environment) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oth-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "MCP server for the OTH (OpenTeleHealth) API",
   "type": "module",
   "bin": {