create_prescription

Generate new prescriptions for patients by specifying medication details, dosage, frequency, and pharmacy information within athenahealth's clinical workflow.

Instructions

Create a new prescription for a patient

Input Schema

TableJSON Schema

Name	Required	Description
`patient_id`	Yes	Patient ID
`medication_name`	Yes	Medication name
`dosage`	Yes	Dosage (e.g., "10mg")
`route`	Yes	Route of administration (e.g., "oral")
`frequency`	Yes	Frequency (e.g., "twice daily")
`quantity`	Yes	Quantity to dispense
`refills`	Yes	Number of refills
`days_supply`	Yes	Days supply
`pharmacy_id`	No	Pharmacy ID (optional)
`notes`	No	Additional notes (optional)

Implementation Reference

src/handlers/tool-handlers.ts:102-146 (handler)

Executes the create_prescription tool: destructures args, maps to prescription data, calls AthenaHealthClient.createPrescription, audits success, returns JSON response or formatted error.

async handleCreatePrescription(args: any) {
  try {
    const { patient_id, ...prescriptionData } = args;
    const prescription = await this.client.createPrescription(patient_id, {
      medicationname: prescriptionData.medication_name,
      dosage: prescriptionData.dosage,
      route: prescriptionData.route,
      frequency: prescriptionData.frequency,
      quantity: prescriptionData.quantity,
      refills: prescriptionData.refills,
      daysupply: prescriptionData.days_supply,
      pharmacyid: prescriptionData.pharmacy_id,
      notes: prescriptionData.notes,
    });

    auditLog('PRESCRIPTION_CREATE', {
      patientId: patient_id,
      result: 'success',
      resourceType: 'PRESCRIPTION',
    });

    return {
      content: [
        {
          type: 'text' as const,
          text: JSON.stringify(prescription, null, 2),
        },
      ],
    };
  } catch (error: any) {
    return {
      content: [
        {
          type: 'text' as const,
          text: JSON.stringify({
            error: 'Failed to create prescription',
            message: error.message || 'Unknown error occurred',
            status: error.status || null,
            note: 'The prescription endpoint is not available in the athenahealth preview/sandbox environment. This endpoint requires a production API account.',
          }, null, 2),
        },
      ],
    };
  }
}

src/definitions/tools.ts:36-55 (schema)

Tool definition including name, description, and input schema specifying parameters and required fields for create_prescription.

{
  name: 'create_prescription',
  description: 'Create a new prescription for a patient',
  inputSchema: {
    type: 'object',
    properties: {
      patient_id: { type: 'string', description: 'Patient ID' },
      medication_name: { type: 'string', description: 'Medication name' },
      dosage: { type: 'string', description: 'Dosage (e.g., "10mg")' },
      route: { type: 'string', description: 'Route of administration (e.g., "oral")' },
      frequency: { type: 'string', description: 'Frequency (e.g., "twice daily")' },
      quantity: { type: 'string', description: 'Quantity to dispense' },
      refills: { type: 'string', description: 'Number of refills' },
      days_supply: { type: 'string', description: 'Days supply' },
      pharmacy_id: { type: 'string', description: 'Pharmacy ID (optional)' },
      notes: { type: 'string', description: 'Additional notes (optional)' },
    },
    required: ['patient_id', 'medication_name', 'dosage', 'route', 'frequency', 'quantity', 'refills', 'days_supply'],
  },
},

src/mcp-server.ts:182-183 (registration)
Dispatch in the CallToolRequestHandler switch statement that routes 'create_prescription' calls to the tool handler.
```
case 'create_prescription':
  return await this.toolHandlers.handleCreatePrescription(args);
```
src/mcp-server.ts:166-168 (registration)
Registers the list of available tools, including create_prescription schema from toolDefinitions.
```
this.server.setRequestHandler(ListToolsRequestSchema, async () => {
  return { tools: toolDefinitions };
});
```

athenahealth MCP Server