@cyanheads/noaa-spaceweather-mcp-server 0.1.1

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

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_conditions — current space-weather snapshot.
+ * @module mcp-server/tools/definitions/get-conditions
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getSpaceWeatherService } from '../../../services/space-weather/space-weather-service.js';
+// ── Output sub-schemas ──────────────────────────────────────────────────────
+const ScaleSummarySchema = z
+    .object({
+    scale: z.number().describe('Storm scale level 0–5.'),
+    text: z
+        .string()
+        .describe('Human-readable scale descriptor, e.g. "Moderate". Empty when scale is 0.'),
+    label: z.string().describe('NOAA scale string, e.g. "G2", "R1", "S0".'),
+})
+    .describe('Current level and label for one NOAA storm scale category.');
+const ForecastPeriodSchema = z
+    .object({
+    date: z.string().describe('Forecast date string.'),
+    G: ScaleSummarySchema.describe('Geomagnetic storm scale for this day.'),
+    R: ScaleSummarySchema.describe('Radio blackout scale for this day.'),
+    S: ScaleSummarySchema.describe('Solar radiation storm scale for this day.'),
+})
+    .describe('3-day NOAA scale forecast for one calendar day.');
+// ── Tool ────────────────────────────────────────────────────────────────────
+export const getConditions = tool('noaa_spaceweather_get_conditions', {
+    title: 'Get Space Weather Conditions',
+    description: 'Current space-weather snapshot: NOAA R/S/G storm scales (today + 3-day forecast), latest Kp ' +
+        'index with its G-scale equivalent and aurora-visibility latitude, and a plain-language status ' +
+        'summary. The quickest way to answer "is anything happening right now?" — use before deciding ' +
+        'whether to drill into solar wind (noaa_spaceweather_get_solar_wind), aurora ' +
+        '(noaa_spaceweather_get_aurora_forecast), or alert details (noaa_spaceweather_get_alerts).',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({}),
+    output: z.object({
+        observedAt: z
+            .string()
+            .describe('UTC date and time of the NOAA scales data period this snapshot reflects, e.g. "2026-06-04 15:00:00".'),
+        currentKp: z.number().describe('Latest observed planetary K-index (0–9).'),
+        currentGScale: z.number().describe('NOAA G-scale equivalent for current Kp (0–5).'),
+        auroraLatitude: z
+            .string()
+            .describe('Aurora visibility guidance for current conditions, e.g. "Aurora possible to ~55° geomagnetic latitude".'),
+        today: z
+            .object({
+            G: ScaleSummarySchema.describe("Today's geomagnetic storm scale."),
+            R: ScaleSummarySchema.describe("Today's radio blackout scale."),
+            S: ScaleSummarySchema.describe("Today's solar radiation storm scale."),
+        })
+            .describe('Current observed NOAA storm scales for today.'),
+        forecast: z.array(ForecastPeriodSchema).describe('3-day NOAA scale forecast (next 1–3 days).'),
+        summary: z
+            .string()
+            .describe('Plain-language status summary suitable for display, e.g. "Quiet conditions" or "G2 moderate geomagnetic storm in progress."'),
+    }),
+    errors: [
+        {
+            reason: 'feed_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'SWPC endpoint returns non-OK status or times out after retries.',
+            retryable: true,
+            recovery: 'Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.',
+        },
+    ],
+    async handler(_input, ctx) {
+        ctx.log.info('Fetching current space weather conditions');
+        const svc = getSpaceWeatherService();
+        const [scales, kpObs] = await Promise.all([svc.getNoaaScales(ctx), svc.getKpObserved(ctx)]);
+        // Latest Kp is the last element of the observed array
+        const latestKp = kpObs.length > 0 ? kpObs[kpObs.length - 1] : null;
+        const currentKp = latestKp?.kp ?? 0;
+        const currentGScale = latestKp?.gScale ?? 0;
+        const auroraLatitude = latestKp?.auroraLatitude ?? 'No significant aurora expected at mid-latitudes';
+        const today = scales.today;
+        // Build summary
+        const parts = [];
+        if (today.G.scale >= 1)
+            parts.push(`G${today.G.scale} ${today.G.text.toLowerCase()} geomagnetic storm`);
+        if (today.R.scale >= 1)
+            parts.push(`R${today.R.scale} ${today.R.text.toLowerCase()} radio blackout`);
+        if (today.S.scale >= 1)
+            parts.push(`S${today.S.scale} ${today.S.text.toLowerCase()} solar radiation storm`);
+        const summary = parts.length > 0
+            ? parts.map((p, i) => (i === 0 ? p.charAt(0).toUpperCase() + p.slice(1) : p)).join('; ') +
+                ' in progress.'
+            : 'Quiet conditions — no significant storms active.';
+        return {
+            observedAt: `${today.date} ${today.time}`,
+            currentKp,
+            currentGScale,
+            auroraLatitude,
+            today: {
+                G: { scale: today.G.scale, text: today.G.text, label: `G${today.G.scale}` },
+                R: { scale: today.R.scale, text: today.R.text, label: `R${today.R.scale}` },
+                S: { scale: today.S.scale, text: today.S.text, label: `S${today.S.scale}` },
+            },
+            forecast: scales.forecast.map((p) => ({
+                date: p.date,
+                G: { scale: p.G.scale, text: p.G.text, label: `G${p.G.scale}` },
+                R: { scale: p.R.scale, text: p.R.text, label: `R${p.R.scale}` },
+                S: { scale: p.S.scale, text: p.S.text, label: `S${p.S.scale}` },
+            })),
+            summary,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## Space Weather Conditions — ${result.observedAt} UTC`);
+        lines.push('');
+        lines.push(`**Summary:** ${result.summary}`);
+        lines.push('');
+        lines.push(`**Current Kp:** ${result.currentKp} | **G-scale:** ${result.currentGScale} — ${result.auroraLatitude}`);
+        lines.push('');
+        lines.push('### Today');
+        lines.push(`- **Geomagnetic (G):** ${result.today.G.label} (scale ${result.today.G.scale}) ${result.today.G.text || 'None'}`);
+        lines.push(`- **Radio Blackout (R):** ${result.today.R.label} (scale ${result.today.R.scale}) ${result.today.R.text || 'None'}`);
+        lines.push(`- **Solar Radiation (S):** ${result.today.S.label} (scale ${result.today.S.scale}) ${result.today.S.text || 'None'}`);
+        if (result.forecast.length > 0) {
+            lines.push('');
+            lines.push('### 3-Day Forecast');
+            for (const day of result.forecast) {
+                lines.push(`**${day.date}:** ${day.G.label} (scale ${day.G.scale}) ${day.G.text || 'None'} | ${day.R.label} (scale ${day.R.scale}) ${day.R.text || 'None'} | ${day.S.label} (scale ${day.S.scale}) ${day.S.text || 'None'}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-conditions.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-kp-index.tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_kp_index — planetary K-index time series.
+ * @module mcp-server/tools/definitions/get-kp-index
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getKpIndex: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    window_days: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    observed: z.ZodArray<z.ZodObject<{
+        timeTag: z.ZodString;
+        kp: z.ZodNumber;
+        gScale: z.ZodNumber;
+        gLabel: z.ZodString;
+        auroraLatitude: z.ZodString;
+    }, z.core.$strip>>;
+    forecast: z.ZodArray<z.ZodObject<{
+        timeTag: z.ZodString;
+        kp: z.ZodNumber;
+        observed: z.ZodString;
+        noaaScale: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    currentKp: z.ZodNumber;
+    currentGScale: z.ZodNumber;
+    auroraLatitude: z.ZodString;
+    observedCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "feed_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
+}], undefined>;
+//# sourceMappingURL=get-kp-index.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-kp-index.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/get-kp-index.tool.js

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_kp_index — planetary K-index time series.
+ * @module mcp-server/tools/definitions/get-kp-index
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getSpaceWeatherService } from '../../../services/space-weather/space-weather-service.js';
+const KpObsSchema = z
+    .object({
+    timeTag: z.string().describe('ISO 8601 3-hour interval time tag.'),
+    kp: z.number().describe('Kp index value 0–9.'),
+    gScale: z.number().describe('NOAA G-scale equivalent (0–5).'),
+    gLabel: z.string().describe('NOAA G-scale label, e.g. "G0", "G3".'),
+    auroraLatitude: z.string().describe('Aurora visibility guidance for this Kp level.'),
+})
+    .describe('One observed Kp 3-hour interval reading.');
+const KpForecastSchema = z
+    .object({
+    timeTag: z.string().describe('ISO 8601 time tag for the forecast interval.'),
+    kp: z.number().describe('Forecasted Kp value.'),
+    observed: z
+        .string()
+        .describe('"observed" for confirmed readings, "predicted" for forecast points.'),
+    noaaScale: z
+        .string()
+        .nullable()
+        .describe('NOAA scale string, e.g. "G1", null when not available.'),
+})
+    .describe('One Kp forecast interval.');
+export const getKpIndex = tool('noaa_spaceweather_get_kp_index', {
+    title: 'Get Kp Index',
+    description: 'Planetary K-index (0–9 geomagnetic activity scale) — recent observed 3-hour values with their ' +
+        'NOAA G-scale equivalents and aurora-latitude guidance, plus the 3-day Kp forecast series. ' +
+        'Kp is the primary driver of aurora visibility and geomagnetic storm severity: Kp≥5 is G1, Kp≥7 ' +
+        'is G3 (aurora to ~50°), Kp≥9 is G5 extreme. Use noaa_spaceweather_get_conditions for a ' +
+        'combined snapshot including storm scales; use this tool when you need the Kp time series or ' +
+        'forecast detail.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        window_days: z
+            .number()
+            .int()
+            .min(1)
+            .max(7)
+            .default(1)
+            .describe('Number of past days of observed Kp to return (1–7, default 1). Larger windows show trend context.'),
+    }),
+    output: z.object({
+        observed: z
+            .array(KpObsSchema)
+            .describe('Observed Kp readings within the requested window, oldest first.'),
+        forecast: z.array(KpForecastSchema).describe('3-day Kp forecast series.'),
+        currentKp: z.number().describe('Latest observed Kp value.'),
+        currentGScale: z.number().describe('NOAA G-scale for current Kp.'),
+        auroraLatitude: z.string().describe('Aurora visibility guidance for current conditions.'),
+        observedCount: z
+            .number()
+            .describe('Number of Kp observations in the observed array, matching the requested window.'),
+    }),
+    errors: [
+        {
+            reason: 'feed_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'SWPC endpoint returns non-OK status or times out after retries.',
+            retryable: true,
+            recovery: 'Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching Kp index', { window_days: input.window_days });
+        const svc = getSpaceWeatherService();
+        const [allObs, forecast] = await Promise.all([svc.getKpObserved(ctx), svc.getKpForecast(ctx)]);
+        // Slice to the requested window
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - input.window_days);
+        const cutoffIso = cutoff.toISOString();
+        const observed = allObs.filter((r) => r.timeTag >= cutoffIso);
+        const latest = observed.length > 0 ? observed[observed.length - 1] : null;
+        const currentKp = latest?.kp ?? 0;
+        const currentGScale = latest?.gScale ?? 0;
+        const auroraLatitude = latest?.auroraLatitude ?? 'No significant aurora expected at mid-latitudes';
+        return {
+            observed: observed.map((r) => ({
+                timeTag: r.timeTag,
+                kp: r.kp,
+                gScale: r.gScale,
+                gLabel: `G${r.gScale}`,
+                auroraLatitude: r.auroraLatitude,
+            })),
+            forecast: forecast.map((r) => ({
+                timeTag: r.timeTag,
+                kp: r.kp,
+                observed: r.observed,
+                noaaScale: r.noaaScale,
+            })),
+            currentKp,
+            currentGScale,
+            auroraLatitude,
+            observedCount: observed.length,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push('## Kp Index');
+        lines.push(`**Current Kp:** ${result.currentKp} (G${result.currentGScale})`);
+        lines.push(`**Aurora:** ${result.auroraLatitude}`);
+        lines.push(`**Observed readings:** ${result.observedCount}`);
+        if (result.observed.length > 0) {
+            lines.push('');
+            lines.push('### Recent Observed Values');
+            for (const r of result.observed) {
+                lines.push(`- ${r.timeTag}: Kp ${r.kp} | G-scale ${r.gScale} (${r.gLabel}) — ${r.auroraLatitude}`);
+            }
+        }
+        if (result.forecast.length > 0) {
+            lines.push('');
+            lines.push('### 3-Day Forecast');
+            for (const r of result.forecast) {
+                const scale = r.noaaScale ? ` (${r.noaaScale})` : '';
+                lines.push(`- ${r.timeTag}: Kp ${r.kp}${scale} [${r.observed}]`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-kp-index.tool.js.map

package/dist/mcp-server/tools/definitions/get-kp-index.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-solar-activity.tool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_solar_activity — solar flares, regions, radiation storms.
+ * @module mcp-server/tools/definitions/get-solar-activity
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getSolarActivity: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    include_regions: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    latestXray: z.ZodNullable<z.ZodObject<{
+        timeTag: z.ZodString;
+        fluxWm2: z.ZodNumber;
+        flareClass: z.ZodString;
+        satellite: z.ZodNumber;
+    }, z.core.$strip>>;
+    recentXray: z.ZodArray<z.ZodObject<{
+        timeTag: z.ZodString;
+        fluxWm2: z.ZodNumber;
+        flareClass: z.ZodString;
+        satellite: z.ZodNumber;
+    }, z.core.$strip>>;
+    probabilities: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        cClass1Day: z.ZodNumber;
+        mClass1Day: z.ZodNumber;
+        xClass1Day: z.ZodNumber;
+        protons1Day: z.ZodNumber;
+    }, z.core.$strip>>;
+    latestProton: z.ZodNullable<z.ZodObject<{
+        timeTag: z.ZodString;
+        fluxPfu: z.ZodNumber;
+        sScale: z.ZodNumber;
+        energy: z.ZodString;
+    }, z.core.$strip>>;
+    sScale: z.ZodNumber;
+    sScaleText: z.ZodString;
+    activeRegions: z.ZodArray<z.ZodObject<{
+        region: z.ZodNumber;
+        location: z.ZodString;
+        latitude: z.ZodString;
+        spotClass: z.ZodString;
+        numberSpots: z.ZodNumber;
+        magClass: z.ZodString;
+        cFlareProbability: z.ZodNumber;
+        mFlareProbability: z.ZodNumber;
+        xFlareProbability: z.ZodNumber;
+        protonProbability: z.ZodNumber;
+        observedDate: z.ZodString;
+    }, z.core.$strip>>;
+    fetchedAt: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "feed_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
+}], undefined>;
+//# sourceMappingURL=get-solar-activity.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-solar-activity.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/get-solar-activity.tool.js

@@ -0,0 +1,237 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_solar_activity — solar flares, regions, radiation storms.
+ * @module mcp-server/tools/definitions/get-solar-activity
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getSpaceWeatherService } from '../../../services/space-weather/space-weather-service.js';
+/** Classify X-ray flux to flare class letter. */
+function classifyFlare(fluxWm2) {
+    if (fluxWm2 >= 1e-4)
+        return 'X';
+    if (fluxWm2 >= 1e-5)
+        return 'M';
+    if (fluxWm2 >= 1e-6)
+        return 'C';
+    if (fluxWm2 >= 1e-7)
+        return 'B';
+    return 'A';
+}
+/** Classify proton flux to NOAA S-scale. */
+function classifySScale(fluxPfu) {
+    if (fluxPfu >= 100000)
+        return 5;
+    if (fluxPfu >= 10000)
+        return 4;
+    if (fluxPfu >= 1000)
+        return 3;
+    if (fluxPfu >= 100)
+        return 2;
+    if (fluxPfu >= 10)
+        return 1;
+    return 0;
+}
+const XraySchema = z
+    .object({
+    timeTag: z.string().describe('ISO 8601 measurement time tag.'),
+    fluxWm2: z.number().describe('X-ray flux in W/m² (0.1-0.8nm long channel from GOES).'),
+    flareClass: z.string().describe('Flare classification letter: A, B, C, M, or X.'),
+    satellite: z.number().describe('GOES satellite number.'),
+})
+    .describe('One GOES X-ray flux reading with flare class.');
+const SolarRegionSchema = z
+    .object({
+    region: z.number().describe('NOAA active region number.'),
+    location: z.string().describe('Heliographic location, e.g. "N17E47".'),
+    latitude: z.string().describe('Heliographic latitude, e.g. "N17".'),
+    spotClass: z.string().describe('Sunspot morphology class.'),
+    numberSpots: z.number().describe('Number of sunspots in this region.'),
+    magClass: z.string().describe('Magnetic field class.'),
+    cFlareProbability: z.number().describe('Probability of a C-class flare (%).'),
+    mFlareProbability: z.number().describe('Probability of an M-class flare (%).'),
+    xFlareProbability: z.number().describe('Probability of an X-class flare (%).'),
+    protonProbability: z.number().describe('Probability of a proton event (%).'),
+    observedDate: z.string().describe('Date this region data was observed.'),
+})
+    .describe('One active solar region with flare probabilities.');
+const ProbsSchema = z
+    .object({
+    date: z.string().describe('Forecast date.'),
+    cClass1Day: z.number().describe('Total probability of a C-class flare for this day (%).'),
+    mClass1Day: z.number().describe('Total probability of an M-class flare for this day (%).'),
+    xClass1Day: z.number().describe('Total probability of an X-class flare for this day (%).'),
+    protons1Day: z.number().describe('Probability of ≥10 MeV proton event for this day (%).'),
+})
+    .describe('Solar flare probability forecast for one day.');
+const ProtonSchema = z
+    .object({
+    timeTag: z.string().describe('ISO 8601 measurement time tag.'),
+    fluxPfu: z.number().describe('Integral proton flux in particle flux units (pfu) at ≥10 MeV.'),
+    sScale: z.number().describe('NOAA S-scale level (0–5) for this flux reading.'),
+    energy: z.string().describe('Energy channel, e.g. ">=10 MeV".'),
+})
+    .describe('One GOES integral proton flux reading with S-scale.');
+export const getSolarActivity = tool('noaa_spaceweather_get_solar_activity', {
+    title: 'Get Solar Activity',
+    description: 'Solar flare and radiation storm picture: recent GOES X-ray flux with flare-class labels (A/B/C/M/X), ' +
+        '3-day flare-class probabilities (C/M/X), active solar regions with per-region flare probabilities, ' +
+        'and GOES integral proton flux at ≥10 MeV with NOAA S-scale. For operators tracking HF radio ' +
+        'blackout (R-scale, driven by X-ray) and radiation storm risk (S-scale, driven by protons). ' +
+        'Active region data helps identify which region is driving current activity.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        include_regions: z
+            .boolean()
+            .default(true)
+            .describe('Include active solar region details (default true). Set false to skip region data and reduce response size.'),
+    }),
+    output: z.object({
+        latestXray: XraySchema.nullable().describe('Most recent GOES X-ray flux reading, null if unavailable.'),
+        recentXray: z
+            .array(XraySchema)
+            .describe('GOES X-ray flux readings from the past hour, oldest first.'),
+        probabilities: z.array(ProbsSchema).describe('3-day flare probability forecasts.'),
+        latestProton: ProtonSchema.nullable().describe('Most recent ≥10 MeV proton flux reading, null if unavailable.'),
+        sScale: z
+            .number()
+            .describe('Current NOAA S-scale for solar radiation storms (0–5), derived from latest proton flux.'),
+        sScaleText: z
+            .string()
+            .describe('Plain-language S-scale description, e.g. "S2 moderate radiation storm".'),
+        activeRegions: z
+            .array(SolarRegionSchema)
+            .describe('Currently active solar regions with per-region flare probabilities. Empty when include_regions=false or no regions are active.'),
+        fetchedAt: z.string().describe('ISO 8601 timestamp of when this data was fetched.'),
+    }),
+    errors: [
+        {
+            reason: 'feed_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'SWPC endpoint returns non-OK status or times out after retries.',
+            retryable: true,
+            recovery: 'Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching solar activity', { include_regions: input.include_regions });
+        const svc = getSpaceWeatherService();
+        const [xray, probs, protons, regions] = await Promise.all([
+            svc.getXrayFlux(ctx),
+            svc.getSolarProbabilities(ctx),
+            svc.getProtonFlux(ctx),
+            input.include_regions ? svc.getSolarRegions(ctx) : Promise.resolve(null),
+        ]);
+        // Latest X-ray
+        const latestXrayRaw = xray.length > 0 ? xray[xray.length - 1] : null;
+        const latestXray = latestXrayRaw
+            ? {
+                timeTag: latestXrayRaw.timeTag,
+                fluxWm2: latestXrayRaw.fluxWm2,
+                flareClass: classifyFlare(latestXrayRaw.fluxWm2),
+                satellite: latestXrayRaw.satellite,
+            }
+            : null;
+        // Recent X-ray — last hour
+        const hourCutoff = new Date();
+        hourCutoff.setHours(hourCutoff.getHours() - 1);
+        const hourCutoffIso = hourCutoff.toISOString();
+        const recentXray = xray
+            .filter((r) => r.timeTag >= hourCutoffIso)
+            .map((r) => ({
+            timeTag: r.timeTag,
+            fluxWm2: r.fluxWm2,
+            flareClass: classifyFlare(r.fluxWm2),
+            satellite: r.satellite,
+        }));
+        // Latest proton / S-scale
+        const latestProtonRaw = protons.length > 0 ? protons[protons.length - 1] : null;
+        const sScale = latestProtonRaw ? classifySScale(latestProtonRaw.fluxPfu) : 0;
+        const sScaleDescriptors = [
+            'No radiation storm',
+            'S1 minor radiation storm',
+            'S2 moderate radiation storm',
+            'S3 strong radiation storm',
+            'S4 severe radiation storm',
+            'S5 extreme radiation storm',
+        ];
+        const sScaleText = sScaleDescriptors[sScale] ?? 'Unknown';
+        const latestProton = latestProtonRaw
+            ? {
+                timeTag: latestProtonRaw.timeTag,
+                fluxPfu: latestProtonRaw.fluxPfu,
+                sScale,
+                energy: latestProtonRaw.energy,
+            }
+            : null;
+        return {
+            latestXray,
+            recentXray,
+            probabilities: probs.map((p) => ({
+                date: p.date,
+                cClass1Day: p.cClass1Day,
+                mClass1Day: p.mClass1Day,
+                xClass1Day: p.xClass1Day,
+                protons1Day: p.protons1Day,
+            })),
+            latestProton,
+            sScale,
+            sScaleText,
+            activeRegions: (regions ?? []).map((r) => ({
+                region: r.region,
+                location: r.location,
+                latitude: r.latitude,
+                spotClass: r.spotClass,
+                numberSpots: r.numberSpots,
+                magClass: r.magClass,
+                cFlareProbability: r.cFlareProbability,
+                mFlareProbability: r.mFlareProbability,
+                xFlareProbability: r.xFlareProbability,
+                protonProbability: r.protonProbability,
+                observedDate: r.observedDate,
+            })),
+            fetchedAt: new Date().toISOString(),
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## Solar Activity — ${result.fetchedAt}`);
+        lines.push(`**Radiation Storm:** ${result.sScaleText} (S-scale ${result.sScale})`);
+        if (result.latestXray) {
+            const x = result.latestXray;
+            lines.push('');
+            lines.push('### Latest X-ray Flux');
+            lines.push(`**Time:** ${x.timeTag} | **Class:** ${x.flareClass} | **Flux:** ${x.fluxWm2} W/m² | **Satellite:** GOES-${x.satellite}`);
+        }
+        if (result.recentXray.length > 0) {
+            lines.push('');
+            lines.push('### X-ray (Past Hour)');
+            for (const r of result.recentXray) {
+                lines.push(`- ${r.timeTag}: ${r.flareClass} class — ${r.fluxWm2} W/m² | GOES-${r.satellite}`);
+            }
+        }
+        if (result.latestProton) {
+            const p = result.latestProton;
+            lines.push('');
+            lines.push('### Proton Flux (≥10 MeV)');
+            lines.push(`**Time:** ${p.timeTag} | **Flux:** ${p.fluxPfu} pfu | **S${p.sScale}** | **Channel:** ${p.energy}`);
+        }
+        if (result.probabilities.length > 0) {
+            lines.push('');
+            lines.push('### Flare Probabilities (3-day forecast)');
+            for (const p of result.probabilities) {
+                lines.push(`**${p.date}:** C=${p.cClass1Day}% | M=${p.mClass1Day}% | X=${p.xClass1Day}% | Proton=${p.protons1Day}%`);
+            }
+        }
+        if (result.activeRegions.length > 0) {
+            lines.push('');
+            lines.push('### Active Solar Regions');
+            for (const r of result.activeRegions) {
+                lines.push(`**AR${r.region}** — Location: ${r.location} | Latitude: ${r.latitude} | Observed: ${r.observedDate}`);
+                lines.push(`  Class: ${r.spotClass}/${r.magClass} | Spots: ${r.numberSpots}`);
+                lines.push(`  Flare: C=${r.cFlareProbability}% M=${r.mFlareProbability}% X=${r.xFlareProbability}% Proton=${r.protonProbability}%`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-solar-activity.tool.js.map

package/dist/mcp-server/tools/definitions/get-solar-activity.tool.js.map

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