acknowledge_alert
Mark clinical alerts as reviewed to maintain accurate patient care tracking and ensure timely follow-up on important healthcare notifications.
Instructions
Acknowledge a clinical alert
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| acknowledged_by | Yes | User acknowledging the alert | |
| alert_id | Yes | Alert ID |
Input Schema (JSON Schema)
{
"properties": {
"acknowledged_by": {
"description": "User acknowledging the alert",
"type": "string"
},
"alert_id": {
"description": "Alert ID",
"type": "string"
}
},
"required": [
"alert_id",
"acknowledged_by"
],
"type": "object"
}
Implementation Reference
- src/handlers/tool-handlers.ts:194-213 (handler)MCP tool handler that extracts alert_id and acknowledged_by from args, calls the client to acknowledge the alert, logs the action, and returns a success 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)Input schema definition for the acknowledge_alert tool, specifying required parameters alert_id and acknowledged_by.{ 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 dispatch/registration in the MCP server's CallToolRequestHandler switch statement, routing acknowledge_alert calls to the handler.case 'acknowledge_alert': return await this.toolHandlers.handleAcknowledgeAlert(args);
- Core API implementation that makes the POST request to AthenaHealth's clinicalalerts/{alertId}/acknowledge endpoint with acknowledgedby parameter.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', }, } ); }