ESA MCP Server

Instructions

Implementation Reference

• src/tools/site/site.ts:215-231 (handler)

  The handler function for the 'site_active_list' tool. It calls api.listSites with parameters for fuzzy search, active status, page 1, and size 500, then returns the JSON-stringified result wrapped in the expected MCP response format.

  export const site_active_list = async () => {
    const res = await api.listSites({
      siteSearchType: 'fuzzy',
      status: 'active',
      pageNumber: 1,
      pageSize: 500,
    } as ListSitesRequest);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(res),
        },
      ],
      success: true,
    };
  };

• src/tools/site/site.ts:90-97 (schema)

  The Tool object definition for 'site_active_list', including the name, description, and input schema (empty properties, no input parameters required).

  export const SITE_ACTIVE_LIST_TOOL: Tool = {
    name: 'site_active_list',
    description: 'List all active sites',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  };

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

  Registration of SITE_ACTIVE_LIST_TOOL in the ESA_OPENAPI_ER_LIST array, which collects tools for the ESA OpenAPI ER functionality.

  export const ESA_OPENAPI_ER_LIST = [
    HTML_DEPLOY_TOOL,
    ROUTINE_CREATE_TOOL,
    ROUTINE_DELETE_TOOL,
    ROUTINE_LIST_TOOL,
    ROUTINE_GET_TOOL,
    ROUTINE_CODE_COMMIT_TOOL,
    ROUTINE_CODE_DEPLOY_TOOL,
    ROUTINE_ROUTE_LIST_TOOL,
    DEPLOYMENT_DELETE_TOOL,
    SITE_ACTIVE_LIST_TOOL,
    SITE_ROUTE_LIST_TOOL,
    ROUTE_CREATE_TOOL,
    ROUTE_DELETE_TOOL,
    ROUTE_UPDATE_TOOL,
    ROUTE_GET_TOOL,
    SITE_MATCH_TOOL,
    ER_RECORD_CREATE_TOOL,
    ER_RECORD_DELETE_TOOL,
    ER_RECORD_LIST_TOOL,
  ];

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

  The esaHandlers object maps tool names to their handler functions, including 'site_active_list' as a key mapping to the imported handler.

  export const esaHandlers: ToolHandlers = {
    site_active_list,
    site_match,
    site_route_list,
    site_record_list,
    routine_create,
    routine_code_commit,
    routine_delete,
    routine_list,
    routine_get,
    routine_code_deploy,
    routine_route_list,
    deployment_delete,
    route_create,
    route_delete,
    route_update,
    route_get,
    er_record_create,
    er_record_delete,
    er_record_list,
    html_deploy,
    create_site,
    update_site_pause,
    get_site_pause,
    create_site_mx_record,
    create_site_ns_record,
    create_site_txt_record,
    create_site_cname_record,
    create_site_a_or_aaaa_record,
    update_record,
    list_records,
    get_record,
    delete_record,
    update_ipv6,
    get_ipv6,
    update_managed_transform,
    get_managed_transform,
    set_certificate,
    apply_certificate,
    get_certificate,
    delete_certificate,
    list_certificates,
    get_certificate_quota,
    list_sites,
  };