athenahealth MCP Server

Instructions

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);

• src/services/clinical-service.ts:115-129 (helper)

  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',
        },
      }
    );
  }