Skip to main content
This document covers athenahealth_get_patient_chart_alert, the AthenaHealth patient chart-alert tool exposed through the Agents Platform.

​
Authentication

Uses the existing AthenaHealth connector credentials. The tool does not accept raw access tokens.

​
athenahealth_get_patient_chart_alert

Fetches a patient’s AthenaHealth chart alert and parses coding-relevant directives. This is read-only.

​
Inputs

Required:
  • patient_id: AthenaHealth patient ID.
Effectively required by AthenaHealth:
  • department_id: the encounter’s department ID. AthenaHealth’s chart-alert endpoint requires a departmentid query parameter, so the call fails without it. Pass the department_id from athenahealth_get_encounter_summary / athenahealth_get_encounter_details.

​
Parsed Directives

The tool returns raw alert text plus a parsed object with fields such as:
  • is_self_pay
  • spravato_buy_bill_status
  • required_provider_name
  • eap_directive
  • coding_directives
The parser is intentionally conservative. It surfaces the raw text so downstream prompts can still inspect details that the deterministic parser did not classify.

​
Output

Common failure reasons:
  • athenahealth_not_connected
  • AthenaHealth API error fetching chart alert

​
Human-readable text

The tool emits markdown for the feed: a ## Chart Alert summary table, a ## Parsed Directives table (self-pay, Spravato Buy & Bill, required provider, EAP), and an ## Alert Text block with the raw alert. The raw payload stays in structuredContent.

​
Agent Instruction Guidance

Call this after athenahealth_get_encounter_summary passes cheap skip checks. Use it before fetching heavy documentation so self-pay / Buy-Bill / required-provider cases can short-circuit early.