Get Vitals

get_vitals Parameters

Required Parameters

None - all parameters are optional

Optional Parameters

1. count (integer or null)

   • Default: 300
   • Description: Number of raw FHIR records to fetch BEFORE filtering. MINIMUM: 300 (automatically enforced). This parameter controls the raw fetch size to ensure sufficient data exists for filtering. Always use high values (≥300) for initial queries. Increase to 1000-5000 for comprehensive historical search scenarios.

2. end_date (date string or null)

3. • Default: null
   • Format: YYYY-MM-DD
   • Description: The latest date (inclusive) to include vital sign records. If not provided, no upper date bound is applied.

4. output_formats (array of strings or null)

   • Default: null
   • Available formats: ["table", "markdown", "timeline", "statistics", "csv"]
   • Description: List of output formats for the vitals data:
     • "table": Structured table format for detailed records
     • "markdown": Markdown-formatted table for documentation
     • "timeline": Chronological view of readings
     • "statistics": Summary statistics and aggregated insights
     • "csv": Comma-separated values format for spreadsheet import
   • Examples of when to use:
     • 'table' for "Show me my blood pressure readings from the last month"
     • 'statistics' for "What is my average heart rate over the past week?"
     • 'csv' for "Export my vitals to a spreadsheet" or "Give me vitals in CSV format"
     • 'markdown' for "Format my vitals for documentation"
     • Multiple formats for comprehensive requests

5. start_date (date string or null)

6. • Default: null
   • Format: YYYY-MM-DD
   • Description: The earliest date (inclusive) to include vital sign records. If not provided, no lower date bound is applied.

7. vitals (array of strings or null)

   • Default: null
   • Available vital types:
     • "Body Temperature"
     • "Blood Pressure"
     • "Heart Rate"
     • "Respiratory Rate"
     • "Oxygen Saturation"
     • "Weight"
     • "Height"
     • "Body Mass Index"
   • Description: Optional list of specific vital sign types to filter by. If not specified, all available vital signs will be retrieved. Use this to focus on specific measurements the user is asking about.

When to Use get_vitals

This tool is designed for retrieving vital signs (clinical measurements) from FHIR Observation resources. Use when users ask about:

• Vital signs, measurements, or monitoring data
• Blood pressure, heart rate, temperature, respiratory rate
• Oxygen saturation (SpO2), pulse, body weight, height, BMI
• Any physiological measurements over time