Get Patient Summary

Overview

get_patient_summary retrieves a comprehensive, standardized patient health summary following the FHIR IPS
(International Patient Summary) specification. The summary can include: Patient Demographics, Allergies &
Intolerances, Medication Summary, Problem List, Immunization History, Vital Signs, Medical Devices, Diagnostic
Results (labs and reports), Procedures, Social History, Pregnancy History, Functional Status, Past Medical History,
and Care Plan. Use include_sections to narrow the response to specific sections, and text_filters to prioritize
matching records within those sections — see the tool's parameter descriptions for detailed guidance on when to
use each.

Required Parameters

None — all parameters are optional.

Optional Parameters

person_id (string)

• Default: None
• The identifier of the person whose FHIR records are to be retrieved. If not provided, extracted from the access token.

text_filters (list of strings)

• Default: None
• Text strings to prioritize matching records — use for specific test results, vitals, time-series, or section-specific requests, with multiple term variations (full name, abbreviations, synonyms). Not for general/broad/vague queries — those should rely on include_sections for routing instead.

include_sections (list of section names)

• Default: None (all sections included)
• Must use exact section names (see Notes for the full list); use ['All'] to explicitly include everything. Case-sensitive.

debug (boolean)

• Default: false
• Whether to display debugging information (including warnings about invalid section names).

ignore_cache (boolean)

• Default: false
• If true, bypasses any cached summaries and fetches fresh data.

Returns

FhirPatientSummary — a result field containing the summary text (may include HTML tags).

Notes

Valid values for include_sections come from the IPS_SECTIONS literal type; invalid section names are logged
and ignored (or, if debug=true, reported back via ctx.info) rather than raising an error — if every provided
section is invalid, the tool falls back to returning all sections.