noaa-tidesandcurrents-mcp

Instructions

Implementation Reference

• src/services/noaa-service.ts:74-79 (handler)

  The core handler function that implements the logic for fetching water levels from the NOAA API by setting product: 'water_level' and calling fetchDataApi.

  async getWaterLevels(params: Record<string, any>): Promise<any> {
    return this.fetchDataApi({
      ...params,
      product: 'water_level'
    });
  }

• src/interfaces/noaa.ts:17-30 (schema)

  Zod schema defining the input parameters for the get_water_levels tool, including validation refinement for date parameters.

  export const GetWaterLevelsSchema = z.object({
    station: StationSchema,
    date: DateSchema,
    begin_date: BeginDateSchema,
    end_date: EndDateSchema,
    range: RangeSchema,
    datum: DatumSchema,
    units: UnitsSchema,
    time_zone: TimeZoneSchema,
    format: FormatSchema,
  }).refine(
    data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range),
    { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" }
  );

• src/tools/water-tools.ts:25-50 (registration)

  Registration of the get_water_levels tool using FastMCP server.addTool, including inline schema and execute handler that wraps noaaService.getWaterLevels.

  server.addTool({
    name: 'get_water_levels',
    description: 'Get water level data for a station',
    parameters: z.object({
      station: StationSchema,
      date: DateSchema,
      begin_date: BeginDateSchema,
      end_date: EndDateSchema,
      range: RangeSchema,
      datum: DatumSchema,
      units: UnitsSchema,
      time_zone: TimeZoneSchema,
      format: FormatSchema,
    }).refine(refineDateParams, { message: dateRefinementMessage }),
    execute: async (params) => {
      try {
        const result = await noaaService.getWaterLevels(params);
        return JSON.stringify(result);
      } catch (error) {
        if (error instanceof Error) {
          throw new Error(`Failed to get water levels: ${error.message}`);
        }
        throw new Error('Failed to get water levels');
      }
    }
  });

• src/server/mcp-server.ts:34-41 (registration)

  Definition and registration of the get_water_levels MCPTool in McpServer class, using GetWaterLevelsSchema and handler wrapping noaaService.getWaterLevels.

  const getWaterLevels: MCPTool = {
    name: "get_water_levels",
    description: "Get water level data for a station",
    inputSchema: GetWaterLevelsSchema,
    handler: async (params) => {
      return this.noaaService.getWaterLevels(params);
    }
  };