Implement a CDS Hooks patient-view service that fires when a patient chart opens, returns information cards with relevant gap-in-care alerts, and handles the prefetch template to avoid extra server round-trips

domain: hl7.org/fhir/us/davinci-crd · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register the service at /.well-known/cds-services with hook: patient-view and declare a prefetch template for Patient and Condition
  2. Accept the CDS Hooks request body (hook, hookInstance, context.patientId, prefetch) and validate the JWT bearer token from the EHR
  3. Evaluate the prefetched data against care gap rules and build Card objects with summary, detail, indicator, and source fields
  4. Return a JSON response with a cards array; omit the suggestions array when no actionable suggestion applies
  5. Handle the case where prefetch data is absent by fetching the FHIR resources directly using the fhirAuthorization token
  6. Return an empty cards array rather than an error when no gaps are found to avoid alert fatigue

Known gotchas

Related routes

Implement a CDS Hooks patient-view service that uses a prefetch template to retrieve Observation resources without a server-side FHIR call and returns a gap-in-care card when a required screening is overdue
cds-hooks.org · 6 steps · unrated
Implement a CDS Hooks service that responds to order-select and order-sign hooks from an EHR to provide real-time clinical decision support cards with suggestions and links
hl7.org/fhir · 5 steps · unrated
Implement CDS Hooks system-action suggestions in an order-sign hook service to automatically add a FHIR MedicationRequest to the patient chart without requiring clinician interaction
hl7.org/fhir/us/davinci-crd · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans