Medplum MCP Server

Instructions

Implementation Reference

• src/tools/conditionUtils.ts:241-287 (handler)

  The core handler function that executes the updateCondition tool logic: reads existing Condition by ID, merges updates, handles null removals, and updates via Medplum client.

  export async function updateCondition(
    args: UpdateConditionArgs,
    client?: MedplumClient,
  ): Promise<Condition | OperationOutcome> {
    const medplumClient = client || medplum;
    await ensureAuthenticated();
    try {
      const { id, ...updates } = args;
      if (!id) {
        throw new Error('Condition ID is required for update.');
      }
      if (Object.keys(updates).length === 0) {
        throw new Error('No updates provided for Condition.');
      }
  
      const existingCondition = (await medplumClient.readResource(
        'Condition',
        id,
      )) as Condition;
  
      const updatedResource: Condition = { ...existingCondition, ...(updates as any) };
      // Handle null values for removal
      if (updates.onsetDateTime === null) delete updatedResource.onsetDateTime;
      if (updates.onsetString === null) delete updatedResource.onsetString;
      if (updates.recordedDate === null) delete updatedResource.recordedDate;
  
      const result = (await medplumClient.updateResource(updatedResource)) as Condition;
      console.log('Condition updated successfully:', result.id);
      return result;
    } catch (error: any) {
      console.error('Error updating Condition:', error);
      const outcome: OperationOutcome = {
        resourceType: 'OperationOutcome',
        issue: [
          {
            severity: 'error',
            code: 'exception',
            diagnostics: `Error updating Condition: ${error.message || 'Unknown error'}`,
          },
        ],
      };
      if (error.outcome) {
        console.error('Server OperationOutcome:', JSON.stringify(error.outcome, null, 2));
        return error.outcome as OperationOutcome;
      }
      return outcome;
    }

• src/index.ts:866-891 (schema)

  MCP tool schema definition including input schema with properties for conditionId, clinicalStatus, verificationStatus, onsetString.

  name: "updateCondition",
  description: "Updates an existing condition. Requires the condition ID and at least one field to update.",
  inputSchema: {
    type: "object",
    properties: {
      conditionId: {
        type: "string",
        description: "The unique ID of the condition to update.",
      },
      clinicalStatus: {
        type: "string",
        description: "The new clinical status of the condition.",
        enum: ["active", "recurrence", "relapse", "inactive", "remission", "resolved"],
      },
      verificationStatus: {
        type: "string",
        description: "The new verification status of the condition.",
        enum: ["unconfirmed", "provisional", "differential", "confirmed", "refuted", "entered-in-error"],
      },
      onsetString: {
        type: "string",
        description: "Update the onset description. To remove this field, provide a `null` value.",
      },
    },
    required: ["conditionId"],
  },

• src/index.ts:985-985 (registration)

  Registration of the updateCondition handler function in the toolMapping object used by the MCP server to dispatch tool calls.

  updateCondition,

• src/index.ts:1027-1043 (registration)

  Special dispatch logic in MCP server handler for updateCondition, converting schema inputs to UpdateConditionArgs format.

          // Special handling for updateCondition
  if (toolName === 'updateCondition') {
    const updateArgs: any = { id };
    if ((updates as any).clinicalStatus) {
      const key = ((updates as any).clinicalStatus as string).toUpperCase() as keyof typeof ConditionClinicalStatusCodes;
      updateArgs.clinicalStatus = { coding: [ConditionClinicalStatusCodes[key]] };
    }
    if ((updates as any).verificationStatus) {
      const verStatusMap: { [key: string]: string } = { 'entered-in-error': 'ENTERED-IN-ERROR' };
      const key = (verStatusMap[(updates as any).verificationStatus] || ((updates as any).verificationStatus as string).toUpperCase()) as keyof typeof ConditionVerificationStatusCodes;
      updateArgs.verificationStatus = { coding: [ConditionVerificationStatusCodes[key]] };
    }
    if ((updates as any).onsetString !== undefined) {
      updateArgs.onsetString = (updates as any).onsetString;
    }
    result = await toolFunction(updateArgs);
  } else {

• src/tools/conditionUtils.ts:103-111 (helper)

  TypeScript interface defining the arguments expected by the updateCondition handler function.

  export interface UpdateConditionArgs {
    id: string;
    clinicalStatus?: CodeableConcept;
    verificationStatus?: CodeableConcept;
    code?: CodeableConcept;
    onsetDateTime?: string | null; // null to remove
    onsetString?: string | null;
    recordedDate?: string | null;
  }