athenahealth MCP Server

Instructions

Implementation Reference

• src/definitions/tools.ts:182-192 (schema)

  Tool schema definition including name, description, and input validation schema requiring 'encounter_id'.

  {
    name: 'get_encounter',
    description: 'Get details of a specific encounter',
    inputSchema: {
      type: 'object',
      properties: {
        encounter_id: { type: 'string', description: 'Encounter ID' },
      },
      required: ['encounter_id'],
    },
  },

• src/handlers/tool-handlers.ts:512-546 (handler)

  Executes the get_encounter tool: parses input, fetches encounter via client, logs audit, returns JSON response or error.

  async handleGetEncounter(args: any) {
    try {
      const { encounter_id } = args;
      const encounter = await this.client.getEncounter(encounter_id);
  
      auditLog('ENCOUNTER_ACCESS', {
        resourceId: encounter_id,
        result: 'success',
        resourceType: 'ENCOUNTER',
      });
  
      return {
        content: [
          {
            type: 'text' as const,
            text: JSON.stringify(encounter, null, 2),
          },
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: 'text' as const,
            text: JSON.stringify({
              error: 'Failed to get encounter',
              message: error.message || 'Unknown error occurred',
              status: error.status || null,
              note: 'Encounter endpoints may not be available in the athenahealth preview/sandbox environment.',
            }, null, 2),
          },
        ],
      };
    }
  }

• src/mcp-server.ts:209-210 (registration)

  Dispatches get_encounter tool calls to the handler in the MCP server's tool execution switch statement.

  case 'get_encounter':
    return await this.toolHandlers.handleGetEncounter(args);