Medplum MCP Server

Instructions

Implementation Reference

• src/tools/organizationUtils.ts:139-170 (handler)

  The core handler function that performs the organization update logic: authenticates, validates inputs, reads existing resource, merges updates safely, and updates via Medplum.
  /** * Updates an existing Organization resource. * @param organizationId - The ID of the organization to update. * @param updates - The partial data to update the organization with. * @returns The updated Organization resource. */ export async function updateOrganization(organizationId: string, updates: UpdateOrganizationArgs): Promise<Organization> { await ensureAuthenticated(); if (!organizationId) { throw new Error('Organization ID is required to update an organization.'); } if (!updates || Object.keys(updates).length === 0) { throw new Error('Updates object cannot be empty for updating an organization.'); } const existingOrganization = await medplum.readResource("Organization", organizationId); if (!existingOrganization) { throw new Error(`Organization with ID ${organizationId} not found.`); } const { resourceType, id, ...safeUpdates } = updates as any; const organizationToUpdate: Organization = { ...existingOrganization, ...safeUpdates, resourceType: "Organization", id: organizationId, }; return medplum.updateResource(organizationToUpdate); }
• src/tools/toolSchemas.ts:144-158 (schema)

  JSON Schema definition for the updateOrganization tool input, specifying parameters like organizationId, name, alias.
  { name: 'updateOrganization', description: "Updates an existing organization. Requires the organization ID and the fields to update.", input_schema: { type: 'object', properties: { organizationId: { type: 'string', description: "The unique ID of the organization to update." }, name: { type: 'string', description: "The new official name of the organization. Optional." }, alias: { type: 'array', items: { type: 'string' }, description: "An updated list of aliases. Optional." }, // Add other updatable fields from UpdateOrganizationArgs as simplified properties for LLM // Example: contact, address - keeping them simple for LLM }, required: ['organizationId'], // At least one update field implied }, },
• src/index.ts:328-350 (registration)

  Tool registration in MCP server: schema included in mcpTools array used by the server.
  { name: "updateOrganization", description: "Updates an existing organization. Requires the organization ID and the fields to update.", inputSchema: { type: "object", properties: { organizationId: { type: "string", description: "The unique ID of the organization to update.", }, name: { type: "string", description: "The new official name of the organization. Optional.", }, alias: { type: "array", items: { type: "string" }, description: "An updated list of aliases. Optional.", }, }, required: ["organizationId"], }, },
• src/index.ts:21-25 (registration)

  Import of the updateOrganization handler function for use in the MCP tool mapping.
  createOrganization, getOrganizationById, updateOrganization, searchOrganizations, } from './tools/organizationUtils.js';
• src/index.ts:962-962 (registration)

  Mapping of 'updateOrganization' string key to the imported handler function in toolMapping object used for execution.
  updateOrganization,
• src/tools/organizationUtils.ts:30-32 (helper)

  TypeScript interface defining the shape of updates accepted by the updateOrganization handler.
  export interface UpdateOrganizationArgs extends Omit<Partial<Organization>, 'resourceType' | 'id'> { // if specific simplified fields are needed, they can be added here }