ESA MCP Server

Instructions

Implementation Reference

• src/tools/er/route.ts:288-296 (handler)

  The core handler function for the 'route_get' tool. It calls the API to get routine route details based on siteId and configId, then returns the JSON-stringified response.

  export const route_get = async (request: CallToolRequest) => {
    const res = await api.getRoutineRoute(
      request.params.arguments as GetRoutineRouteRequest,
    );
    return {
      content: [{ type: 'text', text: JSON.stringify(res) }],
      success: true,
    };
  };

• src/tools/er/route.ts:148-166 (schema)

  The MCP Tool object definition for 'route_get', including name, description, and input schema specifying required numeric parameters siteId and configId.

  export const ROUTE_GET_TOOL: Tool = {
    name: 'route_get',
    description:
      'Get details of a specific route associated with an Edge Routine (ER).',
    inputSchema: {
      type: 'object',
      properties: {
        siteId: {
          type: 'number',
          description: 'The ID of the site',
        },
        configId: {
          type: 'number',
          description: 'The ID of the config',
        },
      },
      required: ['siteId', 'configId'],
    },
  };

• src/tools/list-esa-function.ts:118-118 (registration)

  Includes the ROUTE_GET_TOOL in ESA_OPENAPI_ER_LIST, which provides the list of available tools to the MCP server.

  ROUTE_GET_TOOL,

• src/tools/list-esa-function.ts:180-180 (registration)

  Maps the 'route_get' tool name to its handler function in the esaHandlers object used by the MCP server dispatcher.

  route_get,

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

  The MCP server request handler that dispatches tool calls by invoking the corresponding handler from esaHandlers.

  return await esaHandlers[toolName](request);