LocalTides MCP Server

Instructions

Implementation Reference

• src/tools/derived-product-tools.ts:114-123 (handler)

  The execute handler for the get_high_tide_flooding_annual tool, which delegates to the dpapiService.getHighTideFloodingAnnual method and returns the JSON-stringified result, with error handling.

  execute: async (params) => {
    try {
      const result = await dpapiService.getHighTideFloodingAnnual(params);
      return JSON.stringify(result);
    } catch (error) {
      if (error instanceof Error) {
        throw new Error(`Failed to get high tide flooding annual data: ${error.message}`);
      }
      throw new Error('Failed to get high tide flooding annual data');
    }

• src/schemas/dpapi.ts:63-71 (schema)

  Zod schema defining the input parameters and validation for the get_high_tide_flooding_annual tool.

  export const HighTideFloodingAnnualSchema = z.object({
    station: StationSchema,
    format: FormatSchema,
    datum: DpapiDatumSchema,
    threshold: ThresholdSchema,
    begin_date: z.string().optional().describe('Start date (YYYYMMDD format)'),
    end_date: z.string().optional().describe('End date (YYYYMMDD format)'),
    year_range: YearRangeSchema
  }).describe('Get high tide flooding annual count data');

• src/tools/derived-product-tools.ts:110-125 (registration)

  Registers the get_high_tide_flooding_annual tool with the FastMCP server, including name, description, schema, and handler.

  server.addTool({
    name: 'get_high_tide_flooding_annual',
    description: 'Get high tide flooding annual count data for a station',
    parameters: HighTideFloodingAnnualSchema,
    execute: async (params) => {
      try {
        const result = await dpapiService.getHighTideFloodingAnnual(params);
        return JSON.stringify(result);
      } catch (error) {
        if (error instanceof Error) {
          throw new Error(`Failed to get high tide flooding annual data: ${error.message}`);
        }
        throw new Error('Failed to get high tide flooding annual data');
      }
    }
  });

• src/services/dpapi-service.ts:132-140 (helper)

  DpapiService method that makes the API request to NOAA's /htf/annual endpoint for high tide flooding annual data.

  async getHighTideFloodingAnnual(params: Record<string, any>): Promise<any> {
    const { station, format = 'json', ...rest } = params;
    
    return this.fetchDpapi('/htf/annual', {
      station,
      format,
      ...rest
    });
  }