@cyanheads/noaa-spaceweather-mcp-server 0.1.1

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview noaa-spaceweather-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview noaa-spaceweather-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initSpaceWeatherService } from './services/space-weather/space-weather-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: [],
+    prompts: [],
+    instructions: 'NOAA Space Weather Prediction Center data server — all feeds are public and keyless.\n' +
+        '- Start with noaa_spaceweather_get_conditions for a quick status snapshot.\n' +
+        '- Use noaa_spaceweather_get_aurora_forecast with coordinates for "can I see the aurora?" queries.\n' +
+        '- Use noaa_spaceweather_get_solar_wind for Bz monitoring (southward Bz drives storms).\n' +
+        '- Use noaa_spaceweather_get_alerts for active SWPC watches/warnings.\n' +
+        'Feeds update frequently (solar wind ~1 min, aurora ~5 min, Kp 3-hour intervals).',
+    setup(core) {
+        initSpaceWeatherService(core.config, core.storage);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EACV,wFAAwF;QACxF,8EAA8E;QAC9E,qGAAqG;QACrG,0FAA0F;QAC1F,wEAAwE;QACxE,kFAAkF;IACpF,KAAK,CAAC,IAAI;QACR,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_alerts — active SWPC alerts/watches/warnings.
+ * @module mcp-server/tools/definitions/get-alerts
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getAlerts: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    active_only: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    alerts: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        productType: z.ZodEnum<{
+            Warning: "Warning";
+            Watch: "Watch";
+            Alert: "Alert";
+            Summary: "Summary";
+            Other: "Other";
+        }>;
+        level: z.ZodNumber;
+        phenomenon: z.ZodString;
+        issueDatetime: z.ZodString;
+        validFrom: z.ZodNullable<z.ZodString>;
+        validTo: z.ZodNullable<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    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.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=get-alerts.tool.d.ts.map

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

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

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

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_alerts — active SWPC alerts/watches/warnings.
+ * @module mcp-server/tools/definitions/get-alerts
+ */
+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 AlertSchema = z
+    .object({
+    productId: z.string().describe('SWPC product code, e.g. "WARK04", "ALTK07".'),
+    productType: z
+        .enum(['Warning', 'Watch', 'Alert', 'Summary', 'Other'])
+        .describe('Product classification derived from the code prefix.'),
+    level: z
+        .number()
+        .describe('Numeric severity level from the product code (0 when not applicable).'),
+    phenomenon: z
+        .string()
+        .describe('Short phenomenon name, e.g. "Geomagnetic", "Radio Blackout", "Solar Radiation".'),
+    issueDatetime: z.string().describe('ISO 8601 issue datetime.'),
+    validFrom: z
+        .string()
+        .nullable()
+        .describe('Validity start parsed from the message body, null if not found.'),
+    validTo: z
+        .string()
+        .nullable()
+        .describe('Validity end parsed from the message body, null if not found.'),
+    message: z.string().describe('Full plain-text message body.'),
+})
+    .describe('One SWPC alert, watch, warning, or summary.');
+export const getAlerts = tool('noaa_spaceweather_get_alerts', {
+    title: 'Get Space Weather Alerts',
+    description: 'Active SWPC alerts, watches, and warnings — parsed into structured records with product type, ' +
+        'severity level, issue time, validity window, and plain text. Covers geomagnetic storms, radio ' +
+        'blackouts, radiation storms, and aurora bulletins. With active_only=false, also returns ' +
+        'informational summaries and expired notices.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        active_only: z
+            .boolean()
+            .default(true)
+            .describe('When true (default), return only Warnings, Watches, and Alerts; exclude Summaries and Other. Set false to return all products.'),
+    }),
+    output: z.object({
+        alerts: z.array(AlertSchema).describe('Matching SWPC alert/watch/warning records.'),
+        totalCount: z.number().describe('Count of records in the alerts array.'),
+        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 SWPC alerts', { active_only: input.active_only });
+        const svc = getSpaceWeatherService();
+        const all = await svc.getAlerts(ctx);
+        const filtered = input.active_only
+            ? all.filter((a) => a.productType === 'Warning' || a.productType === 'Watch' || a.productType === 'Alert')
+            : all;
+        if (filtered.length === 0) {
+            ctx.enrich.notice(input.active_only
+                ? 'No active alerts, watches, or warnings. Set active_only=false to include summaries.'
+                : 'No space weather products currently issued.');
+        }
+        return {
+            alerts: filtered.map((a) => ({
+                productId: a.productId,
+                productType: a.productType,
+                level: a.level,
+                phenomenon: a.phenomenon,
+                issueDatetime: a.issueDatetime,
+                validFrom: a.validFrom,
+                validTo: a.validTo,
+                message: a.message,
+            })),
+            totalCount: filtered.length,
+            fetchedAt: new Date().toISOString(),
+        };
+    },
+    enrichment: {
+        notice: z.string().optional().describe('Status notice when no alerts are active.'),
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## SWPC Space Weather Alerts — ${result.fetchedAt}`);
+        lines.push(`**Total:** ${result.totalCount}`);
+        if (result.alerts.length === 0) {
+            lines.push('\n_No active alerts._');
+        }
+        else {
+            for (const alert of result.alerts) {
+                lines.push('');
+                lines.push(`### [${alert.productType}] ${alert.phenomenon} — ${alert.productId}`);
+                lines.push(`**Issued:** ${alert.issueDatetime} | **Level:** ${alert.level}`);
+                if (alert.validFrom)
+                    lines.push(`**Valid From:** ${alert.validFrom}`);
+                if (alert.validTo)
+                    lines.push(`**Valid To:** ${alert.validTo}`);
+                lines.push('');
+                lines.push('```');
+                lines.push(alert.message);
+                lines.push('```');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-alerts.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-aurora-forecast.tool.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_aurora_forecast — OVATION aurora probability grid.
+ * @module mcp-server/tools/definitions/get-aurora-forecast
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getAuroraForecast: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    observationTime: z.ZodString;
+    forecastTime: z.ZodString;
+    localLookup: z.ZodNullable<z.ZodObject<{
+        requestedLatitude: z.ZodNumber;
+        requestedLongitude: z.ZodNumber;
+        gridLatitude: z.ZodNumber;
+        gridLongitude: z.ZodNumber;
+        auroraPercent: z.ZodNumber;
+        minKpRequired: z.ZodNumber;
+        verdict: z.ZodString;
+    }, z.core.$strip>>;
+    gridPointCount: z.ZodNumber;
+    topAuroraPercent: z.ZodNumber;
+    topAuroraRegion: 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.";
+}, {
+    readonly reason: "invalid_coordinates";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "latitude is outside −90–90 or longitude is outside −180–180.";
+    readonly recovery: "Provide latitude in range −90 to 90 and longitude in range −180 to 180.";
+}], undefined>;
+//# sourceMappingURL=get-aurora-forecast.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-aurora-forecast.tool.d.ts.map

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

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

@@ -0,0 +1,202 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_aurora_forecast — OVATION aurora probability grid.
+ * @module mcp-server/tools/definitions/get-aurora-forecast
+ */
+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';
+/** Minimum Kp thresholds by geomagnetic latitude band for aurora visibility. */
+function minKpForLatitude(geomLat) {
+    if (geomLat >= 65)
+        return 0;
+    if (geomLat >= 60)
+        return 2;
+    if (geomLat >= 55)
+        return 4;
+    if (geomLat >= 50)
+        return 5;
+    if (geomLat >= 45)
+        return 6;
+    if (geomLat >= 40)
+        return 7;
+    return 9;
+}
+/** Find the nearest grid point (1° resolution) and return its aurora probability. */
+function lookupGridPoint(grid, lat, lon) {
+    if (grid.length === 0)
+        return null;
+    // Normalize longitude to -180..179
+    const normLon = ((((lon + 180) % 360) + 360) % 360) - 180;
+    let best = null;
+    let bestDist = Infinity;
+    for (const pt of grid) {
+        const dLat = pt.latitude - lat;
+        const dLon = pt.longitude - normLon;
+        const dist = dLat * dLat + dLon * dLon;
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = pt;
+        }
+    }
+    return best
+        ? { auroraPercent: best.auroraPercent, gridLat: best.latitude, gridLon: best.longitude }
+        : null;
+}
+export const getAuroraForecast = tool('noaa_spaceweather_get_aurora_forecast', {
+    title: 'Get Aurora Forecast',
+    description: 'OVATION model aurora forecast for the next ~30–60 min: global grid of aurora probability ' +
+        'percentages by latitude/longitude (1° resolution). With optional coordinates, returns the local ' +
+        'aurora probability at the nearest grid point, the minimum Kp needed for aurora at that latitude, ' +
+        'and a plain-language go/no-go verdict. Without coordinates, returns only global metadata. ' +
+        'Data updates every ~5 minutes. Coordinates are geographic (WGS84), not geomagnetic.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        latitude: z
+            .number()
+            .min(-90)
+            .max(90)
+            .optional()
+            .describe('Geographic latitude in degrees (−90 to 90). Provide with longitude for a local aurora probability lookup.'),
+        longitude: z
+            .number()
+            .min(-180)
+            .max(180)
+            .optional()
+            .describe('Geographic longitude in degrees (−180 to 180). Provide with latitude for a local aurora probability lookup.'),
+    }),
+    output: z.object({
+        observationTime: z.string().describe('Time of the OVATION model observation, ISO 8601.'),
+        forecastTime: z.string().describe('Time the aurora forecast is valid for, ISO 8601.'),
+        localLookup: z
+            .object({
+            requestedLatitude: z
+                .number()
+                .describe('Geographic latitude supplied in the request (degrees, −90 to 90).'),
+            requestedLongitude: z
+                .number()
+                .describe('Geographic longitude supplied in the request (degrees, −180 to 180).'),
+            gridLatitude: z.number().describe('Nearest OVATION grid latitude.'),
+            gridLongitude: z.number().describe('Nearest OVATION grid longitude.'),
+            auroraPercent: z
+                .number()
+                .describe('Aurora probability at the nearest grid point (0–100%).'),
+            minKpRequired: z
+                .number()
+                .describe('Minimum Kp threshold for aurora visibility at this latitude.'),
+            verdict: z
+                .string()
+                .describe('Plain-language visibility verdict, e.g. "Good aurora chance (42%) — Kp≥6 needed at this latitude."'),
+        })
+            .nullable()
+            .describe('Local aurora lookup result. Null when no coordinates were provided.'),
+        gridPointCount: z.number().describe('Total number of grid points in the OVATION model.'),
+        topAuroraPercent: z
+            .number()
+            .describe('Highest aurora probability anywhere on the globe (0–100).'),
+        topAuroraRegion: z
+            .string()
+            .describe('Approximate region of the highest aurora probability grid point.'),
+    }),
+    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.',
+        },
+        {
+            reason: 'invalid_coordinates',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'latitude is outside −90–90 or longitude is outside −180–180.',
+            recovery: 'Provide latitude in range −90 to 90 and longitude in range −180 to 180.',
+        },
+    ],
+    async handler(input, ctx) {
+        // Validate: if one coordinate is provided, the other must be too
+        const hasLat = input.latitude != null;
+        const hasLon = input.longitude != null;
+        if ((hasLat && !hasLon) || (!hasLat && hasLon)) {
+            throw ctx.fail('invalid_coordinates', 'Provide both latitude and longitude, or neither.', {
+                ...ctx.recoveryFor('invalid_coordinates'),
+            });
+        }
+        ctx.log.info('Fetching aurora forecast', {
+            latitude: input.latitude,
+            longitude: input.longitude,
+        });
+        const svc = getSpaceWeatherService();
+        const aurora = await svc.getAuroraForecast(ctx);
+        const grid = aurora.grid;
+        // Find global maximum
+        let topPercent = 0;
+        let topPoint = null;
+        for (const pt of grid) {
+            if (pt.auroraPercent > topPercent) {
+                topPercent = pt.auroraPercent;
+                topPoint = pt;
+            }
+        }
+        const topRegion = topPoint
+            ? `${topPoint.latitude >= 0 ? `${topPoint.latitude}°N` : `${Math.abs(topPoint.latitude)}°S`}, ${topPoint.longitude >= 0 ? `${topPoint.longitude}°E` : `${Math.abs(topPoint.longitude)}°W`}`
+            : 'Unknown';
+        // Local lookup
+        let localLookup = null;
+        if (hasLat && hasLon) {
+            // biome-ignore lint/style/noNonNullAssertion: guarded by hasLat && hasLon checks above
+            const lat = input.latitude;
+            // biome-ignore lint/style/noNonNullAssertion: guarded by hasLat && hasLon checks above
+            const lon = input.longitude;
+            const nearest = lookupGridPoint(grid, lat, lon);
+            if (nearest) {
+                const minKp = minKpForLatitude(Math.abs(lat));
+                const pct = nearest.auroraPercent;
+                let verdict;
+                if (pct >= 30)
+                    verdict = `Good aurora chance (${pct}%) — Kp≥${minKp} needed at this latitude.`;
+                else if (pct >= 5)
+                    verdict = `Low aurora chance (${pct}%) — conditions marginal. Kp≥${minKp} needed.`;
+                else if (minKp === 0)
+                    verdict = `Very low aurora probability (${pct}%) despite favorable latitude — wait for elevated solar activity and higher Kp.`;
+                else
+                    verdict = `Very low aurora probability (${pct}%) at this location. Kp≥${minKp} needed — travel to higher latitudes or wait for elevated Kp.`;
+                localLookup = {
+                    requestedLatitude: lat,
+                    requestedLongitude: lon,
+                    gridLatitude: nearest.gridLat,
+                    gridLongitude: nearest.gridLon,
+                    auroraPercent: pct,
+                    minKpRequired: minKp,
+                    verdict,
+                };
+            }
+        }
+        return {
+            observationTime: aurora.meta.observationTime,
+            forecastTime: aurora.meta.forecastTime,
+            localLookup,
+            gridPointCount: grid.length,
+            topAuroraPercent: topPercent,
+            topAuroraRegion: topRegion,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push('## Aurora Forecast (OVATION)');
+        lines.push(`**Observation Time:** ${result.observationTime}`);
+        lines.push(`**Forecast Valid:** ${result.forecastTime}`);
+        lines.push(`**Global Peak:** ${result.topAuroraPercent}% near ${result.topAuroraRegion}`);
+        lines.push(`**Grid Points:** ${result.gridPointCount}`);
+        if (result.localLookup) {
+            const l = result.localLookup;
+            lines.push('');
+            lines.push('### Local Forecast');
+            lines.push(`**Location:** ${l.requestedLatitude}°, ${l.requestedLongitude}° → nearest grid (${l.gridLatitude}°, ${l.gridLongitude}°)`);
+            lines.push(`**Aurora Probability:** ${l.auroraPercent}%`);
+            lines.push(`**Min Kp Required:** ${l.minKpRequired}`);
+            lines.push(`**Verdict:** ${l.verdict}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-aurora-forecast.tool.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Tool: noaa_spaceweather_get_conditions — current space-weather snapshot.
+ * @module mcp-server/tools/definitions/get-conditions
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getConditions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    observedAt: z.ZodString;
+    currentKp: z.ZodNumber;
+    currentGScale: z.ZodNumber;
+    auroraLatitude: z.ZodString;
+    today: z.ZodObject<{
+        G: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+        R: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+        S: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    forecast: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        G: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+        R: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+        S: z.ZodObject<{
+            scale: z.ZodNumber;
+            text: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    summary: 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-conditions.tool.d.ts.map

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

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