@cyanheads/aviation-weather-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/aviation-get-metar.tool.js

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Tool to fetch current weather observations (METARs) for one or more airports.
+ * @module mcp-server/tools/definitions/aviation-get-metar
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getAviationWeatherService } from '../../../services/aviation-weather/aviation-weather-service.js';
+const CloudLayerSchema = z
+    .object({
+    cover: z.string().describe('Sky cover code: FEW, SCT, BKN, OVC, SKC, CLR.'),
+    base_ft: z.number().describe('Cloud base altitude in feet MSL.'),
+})
+    .describe('A reported cloud layer.');
+export const aviationGetMetar = tool('aviation_get_metar', {
+    title: 'Get METAR Weather Observations',
+    description: 'Get current weather observations (METARs) for one or more airports. Returns decoded fields — wind direction/speed/gusts, visibility, ceiling, temperature, dewpoint, altimeter, cloud layers — plus the computed flight category (VFR/MVFR/IFR/LIFR) and the raw METAR string. Accepts 1–10 ICAO station IDs (e.g., KSEA, KJFK). Use aviation_find_stations to resolve or verify an ICAO ID, or to discover nearby stations.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        station_ids: z
+            .array(z
+            .string()
+            .regex(/^[A-Z]{4}$/)
+            .describe('4-letter ICAO station ID (e.g., KSEA, KJFK).'))
+            .min(1)
+            .max(10)
+            .describe('ICAO station IDs to query. 1–10 stations per call.'),
+        hours: z
+            .number()
+            .int()
+            .min(1)
+            .max(12)
+            .default(1)
+            .describe('Hours of observation history to return (1–12). Default 1 returns only the most recent observation per station.'),
+    }),
+    output: z.object({
+        observations: z
+            .array(z
+            .object({
+            station_id: z.string().describe('ICAO 4-letter station identifier (e.g., KSEA).'),
+            name: z.string().describe('Human-readable station or airport name.'),
+            lat: z.number().describe('Station latitude in decimal degrees.'),
+            lon: z.number().describe('Station longitude in decimal degrees.'),
+            elevation_ft: z.number().describe('Station elevation in feet MSL.'),
+            flight_category: z
+                .string()
+                .describe('Flight category: VFR, MVFR, IFR, or LIFR based on ceiling and visibility.'),
+            metar_type: z
+                .string()
+                .describe('METAR (routine) or SPECI (special observation triggered by significant weather change).'),
+            observed_at: z.string().describe('Observation time in ISO 8601 format (UTC).'),
+            wind: z
+                .object({
+                direction_deg: z
+                    .number()
+                    .nullable()
+                    .describe('Wind direction in degrees true. Null when variable.'),
+                speed_kt: z.number().describe('Wind speed in knots.'),
+                gust_kt: z
+                    .number()
+                    .nullable()
+                    .describe('Gust speed in knots, or null if no gusts reported.'),
+            })
+                .describe('Wind conditions at the station.'),
+            visibility_sm: z
+                .string()
+                .describe('Prevailing visibility in statute miles (e.g., "10+", "3", "1/2").'),
+            ceiling_ft: z
+                .number()
+                .nullable()
+                .describe('Ceiling in feet MSL — lowest BKN or OVC layer base. Null when sky is clear.'),
+            clouds: z
+                .array(CloudLayerSchema)
+                .describe('All reported cloud layers from lowest to highest.'),
+            temp_c: z.number().describe('Temperature in degrees Celsius.'),
+            dewpoint_c: z.number().describe('Dewpoint in degrees Celsius.'),
+            altimeter_inhg: z.number().describe('Altimeter setting in inches of mercury.'),
+            raw_metar: z
+                .string()
+                .describe('Original encoded METAR string (e.g., "KSEA 041453Z 18006KT 10SM FEW035 09/03 A2991").'),
+        })
+            .describe('A single weather observation from one station at one time.'))
+            .describe('Weather observations, one per station/time pair. Multiple entries per station when hours > 1.'),
+    }),
+    errors: [
+        {
+            reason: 'no_stations_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'None of the requested station IDs returned METAR data.',
+            recovery: 'Verify ICAO IDs with aviation_find_stations. Not all stations transmit METARs. Check that the station IDs are 4-letter ICAO format (e.g., KSEA not SEA).',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching METARs', { stationIds: input.station_ids, hours: input.hours });
+        const svc = getAviationWeatherService();
+        const observations = await svc.fetchMetar(input.station_ids, input.hours, ctx);
+        if (observations.length === 0) {
+            throw ctx.fail('no_stations_found', `No METAR data found for: ${input.station_ids.join(', ')}`, {
+                stationIds: input.station_ids,
+                ...ctx.recoveryFor('no_stations_found'),
+            });
+        }
+        ctx.log.info('METARs retrieved', { count: observations.length });
+        return { observations };
+    },
+    format: (result) => {
+        const lines = [];
+        for (const obs of result.observations) {
+            lines.push(`## ${obs.station_id} — ${obs.name}`);
+            lines.push(`**Flight Category:** ${obs.flight_category} | **Type:** ${obs.metar_type} | **Observed:** ${obs.observed_at}`);
+            lines.push(`**Location:** ${obs.lat.toFixed(4)}, ${obs.lon.toFixed(4)} | **Elevation:** ${obs.elevation_ft} ft`);
+            lines.push('');
+            const gustStr = obs.wind.gust_kt != null ? ` gusting ${obs.wind.gust_kt} kt` : '';
+            const dirStr = obs.wind.direction_deg != null ? `${obs.wind.direction_deg}°` : 'variable';
+            lines.push(`**Wind:** ${dirStr} at ${obs.wind.speed_kt} kt${gustStr}`);
+            lines.push(`**Visibility:** ${obs.visibility_sm} sm | **Ceiling:** ${obs.ceiling_ft != null ? `${obs.ceiling_ft} ft` : 'Clear'}`);
+            lines.push(`**Temperature:** ${obs.temp_c}°C | **Dewpoint:** ${obs.dewpoint_c}°C | **Altimeter:** ${obs.altimeter_inhg} inHg`);
+            if (obs.clouds.length > 0) {
+                lines.push(`**Clouds:** ${obs.clouds.map((c) => `${c.cover} @ ${c.base_ft} ft`).join(', ')}`);
+            }
+            else {
+                lines.push(`**Clouds:** Clear`);
+            }
+            lines.push(`**Raw METAR:** \`${obs.raw_metar}\``);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n').trim() }];
+    },
+});
+//# sourceMappingURL=aviation-get-metar.tool.js.map

package/dist/mcp-server/tools/definitions/aviation-get-metar.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aviation-get-metar.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/aviation-get-metar.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/aviation-get-pireps.tool.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Tool to fetch recent Pilot Reports (PIREPs) near an airport or within a bounding box.
+ * @module mcp-server/tools/definitions/aviation-get-pireps
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const aviationGetPireps: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    station_id: z.ZodOptional<z.ZodString>;
+    bbox: z.ZodOptional<z.ZodObject<{
+        minLat: z.ZodNumber;
+        minLon: z.ZodNumber;
+        maxLat: z.ZodNumber;
+        maxLon: z.ZodNumber;
+    }, z.core.$strip>>;
+    distance_nm: z.ZodDefault<z.ZodNumber>;
+    hours: z.ZodDefault<z.ZodNumber>;
+    altitude_min_ft: z.ZodOptional<z.ZodNumber>;
+    altitude_max_ft: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    pireps: z.ZodArray<z.ZodObject<{
+        observed_at: z.ZodString;
+        lat: z.ZodNumber;
+        lon: z.ZodNumber;
+        altitude_ft: z.ZodNumber;
+        aircraft_type: z.ZodNullable<z.ZodString>;
+        pirep_type: z.ZodString;
+        turbulence: z.ZodArray<z.ZodObject<{
+            base_ft: z.ZodNullable<z.ZodNumber>;
+            top_ft: z.ZodNullable<z.ZodNumber>;
+            intensity: z.ZodString;
+            type: z.ZodNullable<z.ZodString>;
+            frequency: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        icing: z.ZodArray<z.ZodObject<{
+            base_ft: z.ZodNullable<z.ZodNumber>;
+            top_ft: z.ZodNullable<z.ZodNumber>;
+            intensity: z.ZodString;
+            type: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        clouds: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            cover: z.ZodString;
+            base_ft: z.ZodNumber;
+            top_ft: z.ZodNumber;
+        }, z.core.$strip>>>;
+        visibility_sm: z.ZodNullable<z.ZodNumber>;
+        remarks: z.ZodNullable<z.ZodString>;
+        raw_pirep: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_pireps_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No pilot reports found in the search area and time window.";
+    readonly recovery: "Expand the distance_nm or hours parameters, or try a different region. PIREPs are sparse; absence of reports does not mean smooth conditions.";
+}, {
+    readonly reason: "missing_location";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither station_id nor bbox was provided.";
+    readonly recovery: "Provide station_id for a radial search (ICAO ID + distance_nm) or bbox for an area search (minLat, minLon, maxLat, maxLon).";
+}], undefined>;
+//# sourceMappingURL=aviation-get-pireps.tool.d.ts.map

package/dist/mcp-server/tools/definitions/aviation-get-pireps.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aviation-get-pireps.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/aviation-get-pireps.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsEjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2M5B,CAAC"}

package/dist/mcp-server/tools/definitions/aviation-get-pireps.tool.js

@@ -0,0 +1,238 @@
+/**
+ * @fileoverview Tool to fetch recent Pilot Reports (PIREPs) near an airport or within a bounding box.
+ * @module mcp-server/tools/definitions/aviation-get-pireps
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getAviationWeatherService } from '../../../services/aviation-weather/aviation-weather-service.js';
+const BboxSchema = z
+    .object({
+    minLat: z.number().min(-90).max(90).describe('Southern boundary latitude in decimal degrees.'),
+    minLon: z
+        .number()
+        .min(-180)
+        .max(180)
+        .describe('Western boundary longitude in decimal degrees.'),
+    maxLat: z.number().min(-90).max(90).describe('Northern boundary latitude in decimal degrees.'),
+    maxLon: z
+        .number()
+        .min(-180)
+        .max(180)
+        .describe('Eastern boundary longitude in decimal degrees.'),
+})
+    .describe('Geographic bounding box for area PIREP search.');
+const TurbulenceLayerSchema = z
+    .object({
+    base_ft: z
+        .number()
+        .nullable()
+        .describe('Turbulence layer base altitude in feet MSL, or null if not specified.'),
+    top_ft: z
+        .number()
+        .nullable()
+        .describe('Turbulence layer top altitude in feet MSL, or null if not specified.'),
+    intensity: z
+        .string()
+        .describe('Turbulence intensity (e.g., NEG, LGT, LGT-MOD, MOD, SEV, EXTRM).'),
+    type: z
+        .string()
+        .nullable()
+        .describe('Turbulence type (e.g., CHOP, CAT), or null if not reported.'),
+    frequency: z
+        .string()
+        .nullable()
+        .describe('Turbulence frequency (e.g., OCNL, CONT), or null if not reported.'),
+})
+    .describe('A reported turbulence layer.');
+const IcingLayerSchema = z
+    .object({
+    base_ft: z
+        .number()
+        .nullable()
+        .describe('Icing layer base altitude in feet MSL, or null if not specified.'),
+    top_ft: z
+        .number()
+        .nullable()
+        .describe('Icing layer top altitude in feet MSL, or null if not specified.'),
+    intensity: z.string().describe('Icing intensity (e.g., NEG, TRC, LGT, MOD, SEV).'),
+    type: z
+        .string()
+        .nullable()
+        .describe('Icing type (e.g., RIME, MIXED, CLEAR), or null if not reported.'),
+})
+    .describe('A reported icing layer.');
+const PirepCloudLayerSchema = z
+    .object({
+    cover: z.string().describe('Cloud cover code (e.g., FEW, SCT, BKN, OVC).'),
+    base_ft: z.number().describe('Cloud base altitude in feet MSL.'),
+    top_ft: z.number().describe('Cloud top altitude in feet MSL.'),
+})
+    .describe('A cloud layer with base and top altitudes.');
+export const aviationGetPireps = tool('aviation_get_pireps', {
+    title: 'Get Pilot Reports (PIREPs)',
+    description: 'Get recent Pilot Reports (PIREPs) near an airport or within a bounding box. Returns decoded turbulence, icing, and cloud reports with altitude, aircraft type, intensity, and the raw PIREP string. Requires either station_id (ICAO center point for radial search, e.g., KSEA) or bbox (area search) — not both. Coverage is US-centric; PIREPs are sparse and absence of reports does not imply smooth conditions.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        station_id: z
+            .string()
+            .regex(/^[A-Z]{4}$/)
+            .optional()
+            .describe('ICAO station ID as center point for radial search (e.g., KSEA). Use with distance_nm.'),
+        bbox: BboxSchema.optional(),
+        distance_nm: z
+            .number()
+            .int()
+            .min(10)
+            .max(500)
+            .default(100)
+            .describe('Search radius in nautical miles around station_id. Only used when station_id is provided. Default 100.'),
+        hours: z
+            .number()
+            .int()
+            .min(1)
+            .max(12)
+            .default(3)
+            .describe('How many hours of history to return. Default 3.'),
+        altitude_min_ft: z
+            .number()
+            .int()
+            .optional()
+            .describe('Filter by minimum altitude in feet MSL (e.g., 18000 for FL180). Optional.'),
+        altitude_max_ft: z
+            .number()
+            .int()
+            .optional()
+            .describe('Filter by maximum altitude in feet MSL (e.g., 35000 for FL350). Optional.'),
+    }),
+    output: z.object({
+        pireps: z
+            .array(z
+            .object({
+            observed_at: z.string().describe('Observation time in ISO 8601 format (UTC).'),
+            lat: z.number().describe('Latitude of the PIREP location in decimal degrees.'),
+            lon: z.number().describe('Longitude of the PIREP location in decimal degrees.'),
+            altitude_ft: z.number().describe('Reported altitude in feet MSL.'),
+            aircraft_type: z
+                .string()
+                .nullable()
+                .describe('Aircraft type designator (e.g., B737, C172), or null if not reported.'),
+            pirep_type: z
+                .string()
+                .describe('Report type: PIREP (pilot report) or AIREP (position report with wx).'),
+            turbulence: z
+                .array(TurbulenceLayerSchema)
+                .describe('Turbulence layers reported. Empty array if no turbulence encountered (NEG).'),
+            icing: z
+                .array(IcingLayerSchema)
+                .describe('Icing layers reported. Empty array if no icing encountered (NEG).'),
+            clouds: z
+                .array(PirepCloudLayerSchema)
+                .nullable()
+                .describe('Cloud layers with base and top altitudes, or null if not reported.'),
+            visibility_sm: z
+                .number()
+                .nullable()
+                .describe('In-flight visibility in statute miles, or null if not reported.'),
+            remarks: z
+                .string()
+                .nullable()
+                .describe('Weather remarks or additional conditions, or null if none.'),
+            raw_pirep: z
+                .string()
+                .describe('Original encoded PIREP string (e.g., "SEA UA /OV KSEA/TM 1530/FL080/TP B737/TB LGT").'),
+        })
+            .describe('A single Pilot Report (PIREP) with decoded hazard information.'))
+            .describe('Pilot reports matching the search criteria, ordered by observation time descending.'),
+    }),
+    errors: [
+        {
+            reason: 'no_pireps_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No pilot reports found in the search area and time window.',
+            recovery: 'Expand the distance_nm or hours parameters, or try a different region. PIREPs are sparse; absence of reports does not mean smooth conditions.',
+        },
+        {
+            reason: 'missing_location',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither station_id nor bbox was provided.',
+            recovery: 'Provide station_id for a radial search (ICAO ID + distance_nm) or bbox for an area search (minLat, minLon, maxLat, maxLon).',
+        },
+    ],
+    async handler(input, ctx) {
+        if (!input.station_id && !input.bbox) {
+            throw ctx.fail('missing_location', 'Either station_id or bbox is required for PIREP search.', {
+                ...ctx.recoveryFor('missing_location'),
+            });
+        }
+        ctx.log.info('Fetching PIREPs', {
+            stationId: input.station_id,
+            hasBbox: !!input.bbox,
+            distanceNm: input.distance_nm,
+            hours: input.hours,
+        });
+        const svc = getAviationWeatherService();
+        let pireps = await svc.fetchPireps({
+            ...(input.station_id ? { stationId: input.station_id } : {}),
+            ...(input.bbox ? { bbox: input.bbox } : {}),
+            distanceNm: input.distance_nm,
+            hours: input.hours,
+        }, ctx);
+        // Client-side altitude filter (capture to const so TypeScript narrows inside the callback)
+        const altMin = input.altitude_min_ft;
+        const altMax = input.altitude_max_ft;
+        if (altMin != null)
+            pireps = pireps.filter((p) => p.altitude_ft >= altMin);
+        if (altMax != null)
+            pireps = pireps.filter((p) => p.altitude_ft <= altMax);
+        // Sort by observation time descending
+        pireps.sort((a, b) => new Date(b.observed_at).getTime() - new Date(a.observed_at).getTime());
+        if (pireps.length === 0) {
+            throw ctx.fail('no_pireps_found', `No PIREPs found in the search area for the past ${input.hours} hour(s).`, { ...ctx.recoveryFor('no_pireps_found') });
+        }
+        ctx.log.info('PIREPs retrieved', { count: pireps.length });
+        return { pireps };
+    },
+    format: (result) => {
+        const lines = [`**${result.pireps.length} PIREP(s) found**\n`];
+        for (const p of result.pireps) {
+            lines.push(`## ${p.pirep_type} — ${p.observed_at}`);
+            lines.push(`**Location:** ${p.lat.toFixed(4)}, ${p.lon.toFixed(4)} | **Altitude:** ${p.altitude_ft.toLocaleString()} ft`);
+            if (p.aircraft_type)
+                lines.push(`**Aircraft:** ${p.aircraft_type}`);
+            if (p.turbulence.length > 0) {
+                lines.push('**Turbulence:**');
+                for (const t of p.turbulence) {
+                    const altStr = t.base_ft != null && t.top_ft != null
+                        ? ` (${t.base_ft.toLocaleString()}–${t.top_ft.toLocaleString()} ft)`
+                        : '';
+                    const details = [t.intensity, t.type, t.frequency].filter(Boolean).join(', ');
+                    lines.push(`  - ${details}${altStr}`);
+                }
+            }
+            if (p.icing.length > 0) {
+                lines.push('**Icing:**');
+                for (const i of p.icing) {
+                    const altStr = i.base_ft != null && i.top_ft != null
+                        ? ` (${i.base_ft.toLocaleString()}–${i.top_ft.toLocaleString()} ft)`
+                        : '';
+                    const details = [i.intensity, i.type].filter(Boolean).join(', ');
+                    lines.push(`  - ${details}${altStr}`);
+                }
+            }
+            if (p.clouds && p.clouds.length > 0) {
+                const cloudStr = p.clouds
+                    .map((c) => `${c.cover} ${c.base_ft.toLocaleString()}–${c.top_ft.toLocaleString()} ft`)
+                    .join(', ');
+                lines.push(`**Clouds:** ${cloudStr}`);
+            }
+            if (p.visibility_sm != null)
+                lines.push(`**Visibility:** ${p.visibility_sm} sm`);
+            if (p.remarks)
+                lines.push(`**Remarks:** ${p.remarks}`);
+            lines.push(`**Raw:** \`${p.raw_pirep}\``);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n').trim() }];
+    },
+});
+//# sourceMappingURL=aviation-get-pireps.tool.js.map

package/dist/mcp-server/tools/definitions/aviation-get-pireps.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aviation-get-pireps.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/aviation-get-pireps.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/aviation-get-taf.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Tool to fetch Terminal Aerodrome Forecasts (TAFs) for one or more airports.
+ * @module mcp-server/tools/definitions/aviation-get-taf
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const aviationGetTaf: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    station_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    forecasts: z.ZodArray<z.ZodObject<{
+        station_id: z.ZodString;
+        name: z.ZodString;
+        issued_at: z.ZodString;
+        valid_from: z.ZodString;
+        valid_to: z.ZodString;
+        forecast_periods: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            change_type: z.ZodNullable<z.ZodString>;
+            probability: z.ZodNullable<z.ZodNumber>;
+            wind: z.ZodObject<{
+                direction_deg: z.ZodNullable<z.ZodNumber>;
+                speed_kt: z.ZodNumber;
+                gust_kt: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            visibility_sm: z.ZodNullable<z.ZodString>;
+            weather: z.ZodNullable<z.ZodString>;
+            clouds: z.ZodArray<z.ZodObject<{
+                cover: z.ZodString;
+                base_ft: z.ZodNumber;
+                type: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        raw_taf: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_taf_available";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Station does not issue TAFs or no TAF is currently available.";
+    readonly recovery: "Not all airports have TAFs — only major airports with scheduled commercial service typically issue them. Check data_types from aviation_find_stations to confirm TAF capability. Smaller airports may only have METARs.";
+}], undefined>;
+//# sourceMappingURL=aviation-get-taf.tool.d.ts.map

package/dist/mcp-server/tools/definitions/aviation-get-taf.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aviation-get-taf.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/aviation-get-taf.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAoDjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyGzB,CAAC"}

package/dist/mcp-server/tools/definitions/aviation-get-taf.tool.js

@@ -0,0 +1,140 @@
+/**
+ * @fileoverview Tool to fetch Terminal Aerodrome Forecasts (TAFs) for one or more airports.
+ * @module mcp-server/tools/definitions/aviation-get-taf
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getAviationWeatherService } from '../../../services/aviation-weather/aviation-weather-service.js';
+const TafCloudLayerSchema = z
+    .object({
+    cover: z.string().describe('Sky cover code: FEW, SCT, BKN, OVC, SKC, CLR.'),
+    base_ft: z.number().describe('Cloud base altitude in feet MSL.'),
+    type: z
+        .string()
+        .nullable()
+        .describe('Cloud type qualifier: CB (cumulonimbus), TCU (towering cumulus), or null.'),
+})
+    .describe('A forecast cloud layer.');
+const ForecastPeriodSchema = z
+    .object({
+    from: z.string().describe('Period start time in ISO 8601 format (UTC).'),
+    to: z.string().describe('Period end time in ISO 8601 format (UTC).'),
+    change_type: z
+        .string()
+        .nullable()
+        .describe('Change indicator: FM (from), TEMPO (temporary), BECMG (becoming), or null for the base period.'),
+    probability: z
+        .number()
+        .nullable()
+        .describe('Probability percentage (30 or 40) for TEMPO/PROB groups. Null if not specified.'),
+    wind: z
+        .object({
+        direction_deg: z
+            .number()
+            .nullable()
+            .describe('Forecast wind direction in degrees true. Null when variable.'),
+        speed_kt: z.number().describe('Forecast wind speed in knots.'),
+        gust_kt: z.number().nullable().describe('Forecast gust speed in knots, or null if none.'),
+    })
+        .describe('Forecast wind conditions for this period.'),
+    visibility_sm: z
+        .string()
+        .nullable()
+        .describe('Forecast visibility in statute miles (e.g., "6", "1/2"). Null if not specified.'),
+    weather: z
+        .string()
+        .nullable()
+        .describe('Decoded weather condition (e.g., "light rain showers", "thunderstorm with rain"). Null if none.'),
+    clouds: z.array(TafCloudLayerSchema).describe('Forecast cloud layers for this period.'),
+})
+    .describe('A single TAF forecast period.');
+export const aviationGetTaf = tool('aviation_get_taf', {
+    title: 'Get Terminal Aerodrome Forecast (TAF)',
+    description: 'Get the Terminal Aerodrome Forecast (TAF) for one or more airports. Returns each forecast period with valid times, wind, visibility, decoded weather conditions, and cloud layers, plus the raw TAF string. TAFs cover the next 24–30 hours and are issued only for airports with scheduled commercial service; check data_types from aviation_find_stations to confirm TAF availability. Accepts 1–4 ICAO station IDs (e.g., KSEA, KJFK).',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        station_ids: z
+            .array(z
+            .string()
+            .regex(/^[A-Z]{4}$/)
+            .describe('4-letter ICAO station ID (e.g., KSEA, KJFK).'))
+            .min(1)
+            .max(4)
+            .describe('ICAO station IDs to query. 1–4 stations per call.'),
+    }),
+    output: z.object({
+        forecasts: z
+            .array(z
+            .object({
+            station_id: z.string().describe('ICAO 4-letter station identifier (e.g., KSEA).'),
+            name: z.string().describe('Human-readable station or airport name.'),
+            issued_at: z.string().describe('TAF issue time in ISO 8601 format (UTC).'),
+            valid_from: z
+                .string()
+                .describe('Forecast validity period start in ISO 8601 format (UTC).'),
+            valid_to: z.string().describe('Forecast validity period end in ISO 8601 format (UTC).'),
+            forecast_periods: z
+                .array(ForecastPeriodSchema)
+                .describe('Ordered list of forecast periods from base to end of validity.'),
+            raw_taf: z
+                .string()
+                .describe('Original encoded TAF string (e.g., "TAF KSEA 041730Z 0418/0524 18010KT P6SM SKC ...").'),
+        })
+            .describe('A Terminal Aerodrome Forecast for one station.'))
+            .describe('TAF forecasts, one per requested station.'),
+    }),
+    errors: [
+        {
+            reason: 'no_taf_available',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Station does not issue TAFs or no TAF is currently available.',
+            recovery: 'Not all airports have TAFs — only major airports with scheduled commercial service typically issue them. Check data_types from aviation_find_stations to confirm TAF capability. Smaller airports may only have METARs.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching TAFs', { stationIds: input.station_ids });
+        const svc = getAviationWeatherService();
+        const forecasts = await svc.fetchTaf(input.station_ids, ctx);
+        if (forecasts.length === 0) {
+            throw ctx.fail('no_taf_available', `No TAF data found for: ${input.station_ids.join(', ')}`, {
+                stationIds: input.station_ids,
+                ...ctx.recoveryFor('no_taf_available'),
+            });
+        }
+        ctx.log.info('TAFs retrieved', { count: forecasts.length });
+        return { forecasts };
+    },
+    format: (result) => {
+        const lines = [];
+        for (const taf of result.forecasts) {
+            lines.push(`## ${taf.station_id} — ${taf.name}`);
+            lines.push(`**Issued:** ${taf.issued_at} | **Valid:** ${taf.valid_from} → ${taf.valid_to}`);
+            lines.push('');
+            for (const period of taf.forecast_periods) {
+                const changeLabel = period.change_type ? `**${period.change_type}** ` : '';
+                const probLabel = period.probability ? ` (${period.probability}%)` : '';
+                lines.push(`### ${changeLabel}${period.from} → ${period.to}${probLabel}`);
+                const gustStr = period.wind.gust_kt != null ? ` gusting ${period.wind.gust_kt} kt` : '';
+                const dirStr = period.wind.direction_deg != null ? `${period.wind.direction_deg}°` : 'variable';
+                lines.push(`**Wind:** ${dirStr} at ${period.wind.speed_kt} kt${gustStr}`);
+                if (period.visibility_sm != null) {
+                    lines.push(`**Visibility:** ${period.visibility_sm} sm`);
+                }
+                if (period.weather) {
+                    lines.push(`**Weather:** ${period.weather}`);
+                }
+                if (period.clouds.length > 0) {
+                    const cloudStr = period.clouds
+                        .map((c) => `${c.cover} @ ${c.base_ft} ft${c.type ? ` (${c.type})` : ''}`)
+                        .join(', ');
+                    lines.push(`**Clouds:** ${cloudStr}`);
+                }
+                lines.push('');
+            }
+            lines.push(`**Raw TAF:** \`${taf.raw_taf}\``);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n').trim() }];
+    },
+});
+//# sourceMappingURL=aviation-get-taf.tool.js.map