acknowledge_alert
Acknowledge clinical alerts in athenahealth workflows to confirm review and maintain accurate patient care documentation.
Instructions
Acknowledge a clinical alert
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alert_id | Yes | Alert ID | |
| acknowledged_by | Yes | User acknowledging the alert |
Implementation Reference
- src/handlers/tool-handlers.ts:194-213 (handler)The primary MCP tool handler that executes acknowledge_alert: destructures arguments, calls the AthenaHealthClient, logs audit trail, and returns standardized MCP response.
async handleAcknowledgeAlert(args: any) { const { alert_id, acknowledged_by } = args; await this.client.acknowledgeAlert(alert_id, acknowledged_by); auditLog('ALERT_ACKNOWLEDGE', { resourceType: 'CLINICAL_ALERT', resourceId: alert_id, userId: acknowledged_by, result: 'success', }); return { content: [ { type: 'text' as const, text: JSON.stringify({ success: true, message: 'Alert acknowledged' }, null, 2), }, ], }; } - src/definitions/tools.ts:75-86 (schema)MCP tool schema definition specifying input validation for alert_id and acknowledged_by parameters.
{ name: 'acknowledge_alert', description: 'Acknowledge a clinical alert', inputSchema: { type: 'object', properties: { alert_id: { type: 'string', description: 'Alert ID' }, acknowledged_by: { type: 'string', description: 'User acknowledging the alert' }, }, required: ['alert_id', 'acknowledged_by'], }, }, - src/mcp-server.ts:188-189 (registration)Tool registration in MCP server: switch case in CallToolRequestSchema handler dispatches to the specific tool handler method.
case 'acknowledge_alert': return await this.toolHandlers.handleAcknowledgeAlert(args); - Core service helper: makes the actual HTTP POST request to Athenahealth API endpoint to acknowledge the clinical alert.
async acknowledgeAlert(alertId: string, acknowledgedBy: string): Promise<void> { const formData = new URLSearchParams(); formData.append('acknowledgedby', acknowledgedBy); await this.makeRequest( `${this.config.practice_id}/clinicalalerts/${alertId}/acknowledge`, { method: 'POST', data: formData.toString(), headers: { 'Content-Type': 'application/x-www-form-urlencoded', }, } ); }