@cyanheads/noaa-spaceweather-mcp-server 0.1.11 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** noaa-spaceweather-mcp-server
4
- **Version:** 0.1.11
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
6
- **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
- **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
- **Zod:** ^4.4.3
4
+ **Version:** 0.1.13
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.2`
6
+ **Engines:** Bun ≥1.4.0, Node ≥24.0.0
7
+ **MCP SDK:** `@modelcontextprotocol/server` ^2.0.0 (protocol revisions 2026-07-28 and 2025-*)
8
+ **Zod:** ^4.6.4
9
9
 
10
10
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
11
11
 
@@ -35,7 +35,6 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
35
35
  - **Logic throws, framework catches.** Tool/resource handlers are pure — throw on failure, no `try/catch`. Plain `Error` is fine; the framework catches, classifies, and formats. Use error factories (`notFound()`, `validationError()`, etc.) when the error code matters.
36
36
  - **Use `ctx.log`** for request-scoped logging. No `console` calls.
37
37
  - **Use `ctx.state`** for tenant-scoped storage. Never access persistence directly.
38
- - **Check `ctx.elicit`** for presence before calling.
39
38
  - **Secrets in env vars only** — never hardcoded.
40
39
  - **Close the loop on issues.** When implementing work tracked by a GitHub issue, comment on the issue with what landed and close it. Do both — a comment without a close leaves stale issues open; a close without a comment leaves no record of what shipped. The comment is for future readers — state the concrete changes, not the conversation that produced them.
41
40
 
@@ -93,6 +92,12 @@ export const getConditions = tool('noaa_spaceweather_get_conditions', {
93
92
 
94
93
  `createApp({ instructions })` — this server sets server-level orientation for SWPC feed guidance (start with `get_conditions`, use `get_solar_wind` for Bz monitoring, feed cadences). Sent on every `initialize`; client adoption varies.
95
94
 
95
+ ### Session posture and shutdown
96
+
97
+ `createApp({ sessionMode: 'stateless' })` declares the HTTP session posture in `src/` rather than leaving it to a deployment's `MCP_SESSION_MODE`, which still wins whenever it carries a meaningful value (an empty string and an unsubstituted `${…}` placeholder read as unset and fall through to the option). Stateless is correct here: no tool asks the caller for input mid-handler via `ctx.requestInput`, so nothing needs `require: 'stateful'`.
98
+
99
+ `createApp({ teardown })` is the `setup()` counterpart — release a watcher, socket, or non-`unref()`'d timer there. `SpaceWeatherService` is fetch-only and allocates none, so this server declares no hook.
100
+
96
101
  ---
97
102
 
98
103
  ## Context
@@ -101,7 +106,7 @@ Handlers receive a unified `ctx` object. Key properties:
101
106
 
102
107
  | Property | Description |
103
108
  |:---------|:------------|
104
- | `ctx.log` | Request-scoped logger — `.debug()`, `.info()`, `.notice()`, `.warning()`, `.error()`. Auto-correlates requestId, traceId, tenantId. |
109
+ | `ctx.log` | Request-scoped logger — `.debug()`, `.info()`, `.notice()`, `.warning()`, `.error()`. Auto-correlates requestId, traceId, tenantId. Dual-sink: Pino and `notifications/message` to the client, so treat it as client-visible. |
105
110
  | `ctx.fail` | Typed error thrower — `ctx.fail('reason', message, opts?)` maps to declared `errors[]` contract. |
106
111
  | `ctx.enrich` | Attach advisory fields to a successful response — `ctx.enrich.notice(text)`, `.total(n)`, `.echo(query)`, `.delta({...})`. Requires a declared `enrichment` block on the tool; without one the values are silently stripped. |
107
112
  | `ctx.recoveryFor` | Spread into an error options object to attach the declared recovery hint: `...ctx.recoveryFor('reason')`. |
@@ -115,7 +120,7 @@ Handlers receive a unified `ctx` object. Key properties:
115
120
 
116
121
  Handlers throw — the framework catches, classifies, and formats.
117
122
 
118
- **Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`) bubble freely and don't need declaring.
123
+ **Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`, `RequestCancelled`) bubble freely and don't need declaring.
119
124
 
120
125
  ```ts
121
126
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
@@ -190,9 +195,9 @@ src/
190
195
 
191
196
  ## Skills
192
197
 
193
- Skills are modular instructions in `skills/` at the project root. Read them directly when a task matches — e.g., `skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry.
198
+ Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
194
199
 
195
- **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
200
+ **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
196
201
 
197
202
  Available skills:
198
203
 
@@ -211,8 +216,9 @@ Available skills:
211
216
  | `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
212
217
  | `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
213
218
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
214
- | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
215
- | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
219
+ | `git-wrapup` | Land working-tree changes as a commit stack — version bump, changelog, verify, commit by concern, release commit on top. No tag, no push to main; opens the release PR when the project declares release PR mode |
220
+ | `release-pr-review` | Review pass on an open release PR — simplifier + correctness review, fixup commits autosquashed into the stack, PR body kept in sync. Release PR mode only |
221
+ | `release-and-publish` | Fast-forward merge (release PR mode) + tag + push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
216
222
  | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
217
223
  | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
218
224
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
@@ -221,7 +227,7 @@ Available skills:
221
227
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
222
228
  | `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
223
229
  | `api-config` | AppConfig, parseConfig, env vars |
224
- | `api-context` | Context interface, logger, state, progress |
230
+ | `api-context` | Context interface, RequestContext, logger, state, multi-round-trip input |
225
231
  | `api-errors` | McpError, JsonRpcErrorCode, error patterns |
226
232
  | `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
227
233
  | `api-mirror` | MirrorService: persistent self-refreshing local mirror (embedded SQLite + FTS5) of a bulk upstream dataset — Tier 3 opt-in |
@@ -231,7 +237,7 @@ Available skills:
231
237
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
232
238
  | `api-workers` | Cloudflare Workers runtime |
233
239
 
234
- **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
240
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `framework-skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
235
241
 
236
242
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
237
243
 
@@ -247,7 +253,8 @@ When you complete a skill's checklist, check the boxes and add a completion time
247
253
  | `bun run rebuild` | Clean + build |
248
254
  | `bun run clean` | Remove build artifacts |
249
255
  | `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
250
- | `bun run audit:refresh` | Delete `bun.lock`, reinstall, and re-run `bun audit`. Use when `devcheck` flags a transitive advisory — Bun's `update` is sticky on transitive resolutions, so the advisory may be a stale-lockfile false positive. If it survives the refresh, it's real. |
256
+ | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
257
+ | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
251
258
  | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
252
259
  | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
253
260
  | `bun run list-skills` | Print the skill registry |
@@ -265,11 +272,11 @@ When you complete a skill's checklist, check the boxes and add a completion time
265
272
 
266
273
  ## Bundling
267
274
 
268
- `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`node_modules/**` `skills/`, `.claude/`, `.agents/`, `SKILL.md`) that root-anchored `.mcpbignore` patterns cannot reach. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
275
+ `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
269
276
 
270
- **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
277
+ **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
271
278
 
272
- **README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `skills/polish-docs-meta/references/readme.md`.
279
+ **README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `framework-skills/polish-docs-meta/references/readme.md`.
273
280
 
274
281
  ---
275
282
 
@@ -294,12 +301,18 @@ security: false # optional — true ONLY for a source
294
301
 
295
302
  `agent-notes` is an optional free-form field for maintenance agents processing the release downstream. Content here won't appear in the rendered CHANGELOG — it's consumed by agents running the `maintenance` skill. Use it for adoption instructions that don't fit the human-facing sections: new files to create, fields to populate, one-time migration steps. Omit entirely when there's nothing to say.
296
303
 
297
- **Section order** (Keep a Changelog): Added, Changed, Deprecated, Removed, Fixed, Security. Include only sections with entries — don't ship empty headers.
304
+ **Section order:** the Keep a Changelog sequence — Added, Changed, Deprecated, Removed, Fixed, Security — then `Dependencies` last. Include only sections with entries — don't ship empty headers.
298
305
 
299
306
  **Tag annotations** render as GitHub Release bodies via `--notes-from-tag`. They must be structured markdown — never a flat comma-separated string. Subject omits the version number (GitHub prepends it). See `changelog/template.md` for the full format reference.
300
307
 
301
308
  ---
302
309
 
310
+ ## Publishing
311
+
312
+ **Every release goes through a release PR, straight-through** — `git-wrapup`'s "Release PR mode", mode `straight-through`. One run: `git-wrapup` lands the commit stack on `release/<version>`, pushes it, and opens the PR (title = the release commit subject, body = the changelog entry plus a gates section); `release-and-publish` then fast-forwards `main` locally with `git merge --ff-only`, creates the tag on `main`'s tip, pushes `main` and the tag, deletes the branch, and publishes. A caller's brief may run a given release as `gated` instead — a `release-pr-review` pass on the open PR before `release-and-publish`. **Never merge through the GitHub UI or `gh pr merge`**: squash and rebase-merge are disabled in the repo settings because both rewrite the stack (rebase-merge also strips the SSH signatures), and a merge commit breaks the linear history.
313
+
314
+ ---
315
+
303
316
  ## Imports
304
317
 
305
318
  ```ts
@@ -326,7 +339,7 @@ import { getMyService } from '@/services/my-domain/my-service.js';
326
339
  - [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
327
340
  - [ ] Registered in `createApp()` arrays (directly or via barrel exports)
328
341
  - [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
329
- - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = package name; `interface.shortDescription` from `package.json` description
330
- - [ ] `.codex-plugin/mcp.json` updated — server name key matches `package.json` name; env vars added for any required API keys
331
- - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; inline `mcpServers` entry with server name key, env vars for any required API keys
342
+ - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
343
+ - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
344
+ - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
332
345
  - [ ] `npm run devcheck` passes
package/CLAUDE.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** noaa-spaceweather-mcp-server
4
- **Version:** 0.1.11
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
6
- **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
- **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
- **Zod:** ^4.4.3
4
+ **Version:** 0.1.13
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.2`
6
+ **Engines:** Bun ≥1.4.0, Node ≥24.0.0
7
+ **MCP SDK:** `@modelcontextprotocol/server` ^2.0.0 (protocol revisions 2026-07-28 and 2025-*)
8
+ **Zod:** ^4.6.4
9
9
 
10
10
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
11
11
 
@@ -35,7 +35,6 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
35
35
  - **Logic throws, framework catches.** Tool/resource handlers are pure — throw on failure, no `try/catch`. Plain `Error` is fine; the framework catches, classifies, and formats. Use error factories (`notFound()`, `validationError()`, etc.) when the error code matters.
36
36
  - **Use `ctx.log`** for request-scoped logging. No `console` calls.
37
37
  - **Use `ctx.state`** for tenant-scoped storage. Never access persistence directly.
38
- - **Check `ctx.elicit`** for presence before calling.
39
38
  - **Secrets in env vars only** — never hardcoded.
40
39
  - **Close the loop on issues.** When implementing work tracked by a GitHub issue, comment on the issue with what landed and close it. Do both — a comment without a close leaves stale issues open; a close without a comment leaves no record of what shipped. The comment is for future readers — state the concrete changes, not the conversation that produced them.
41
40
 
@@ -93,6 +92,12 @@ export const getConditions = tool('noaa_spaceweather_get_conditions', {
93
92
 
94
93
  `createApp({ instructions })` — this server sets server-level orientation for SWPC feed guidance (start with `get_conditions`, use `get_solar_wind` for Bz monitoring, feed cadences). Sent on every `initialize`; client adoption varies.
95
94
 
95
+ ### Session posture and shutdown
96
+
97
+ `createApp({ sessionMode: 'stateless' })` declares the HTTP session posture in `src/` rather than leaving it to a deployment's `MCP_SESSION_MODE`, which still wins whenever it carries a meaningful value (an empty string and an unsubstituted `${…}` placeholder read as unset and fall through to the option). Stateless is correct here: no tool asks the caller for input mid-handler via `ctx.requestInput`, so nothing needs `require: 'stateful'`.
98
+
99
+ `createApp({ teardown })` is the `setup()` counterpart — release a watcher, socket, or non-`unref()`'d timer there. `SpaceWeatherService` is fetch-only and allocates none, so this server declares no hook.
100
+
96
101
  ---
97
102
 
98
103
  ## Context
@@ -101,7 +106,7 @@ Handlers receive a unified `ctx` object. Key properties:
101
106
 
102
107
  | Property | Description |
103
108
  |:---------|:------------|
104
- | `ctx.log` | Request-scoped logger — `.debug()`, `.info()`, `.notice()`, `.warning()`, `.error()`. Auto-correlates requestId, traceId, tenantId. |
109
+ | `ctx.log` | Request-scoped logger — `.debug()`, `.info()`, `.notice()`, `.warning()`, `.error()`. Auto-correlates requestId, traceId, tenantId. Dual-sink: Pino and `notifications/message` to the client, so treat it as client-visible. |
105
110
  | `ctx.fail` | Typed error thrower — `ctx.fail('reason', message, opts?)` maps to declared `errors[]` contract. |
106
111
  | `ctx.enrich` | Attach advisory fields to a successful response — `ctx.enrich.notice(text)`, `.total(n)`, `.echo(query)`, `.delta({...})`. Requires a declared `enrichment` block on the tool; without one the values are silently stripped. |
107
112
  | `ctx.recoveryFor` | Spread into an error options object to attach the declared recovery hint: `...ctx.recoveryFor('reason')`. |
@@ -115,7 +120,7 @@ Handlers receive a unified `ctx` object. Key properties:
115
120
 
116
121
  Handlers throw — the framework catches, classifies, and formats.
117
122
 
118
- **Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`) bubble freely and don't need declaring.
123
+ **Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`, `RequestCancelled`) bubble freely and don't need declaring.
119
124
 
120
125
  ```ts
121
126
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
@@ -190,9 +195,9 @@ src/
190
195
 
191
196
  ## Skills
192
197
 
193
- Skills are modular instructions in `skills/` at the project root. Read them directly when a task matches — e.g., `skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry.
198
+ Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
194
199
 
195
- **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
200
+ **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
196
201
 
197
202
  Available skills:
198
203
 
@@ -211,8 +216,9 @@ Available skills:
211
216
  | `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
212
217
  | `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
213
218
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
214
- | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
215
- | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
219
+ | `git-wrapup` | Land working-tree changes as a commit stack — version bump, changelog, verify, commit by concern, release commit on top. No tag, no push to main; opens the release PR when the project declares release PR mode |
220
+ | `release-pr-review` | Review pass on an open release PR — simplifier + correctness review, fixup commits autosquashed into the stack, PR body kept in sync. Release PR mode only |
221
+ | `release-and-publish` | Fast-forward merge (release PR mode) + tag + push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
216
222
  | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
217
223
  | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
218
224
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
@@ -221,7 +227,7 @@ Available skills:
221
227
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
222
228
  | `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
223
229
  | `api-config` | AppConfig, parseConfig, env vars |
224
- | `api-context` | Context interface, logger, state, progress |
230
+ | `api-context` | Context interface, RequestContext, logger, state, multi-round-trip input |
225
231
  | `api-errors` | McpError, JsonRpcErrorCode, error patterns |
226
232
  | `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
227
233
  | `api-mirror` | MirrorService: persistent self-refreshing local mirror (embedded SQLite + FTS5) of a bulk upstream dataset — Tier 3 opt-in |
@@ -231,7 +237,7 @@ Available skills:
231
237
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
232
238
  | `api-workers` | Cloudflare Workers runtime |
233
239
 
234
- **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
240
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `framework-skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
235
241
 
236
242
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
237
243
 
@@ -247,7 +253,8 @@ When you complete a skill's checklist, check the boxes and add a completion time
247
253
  | `bun run rebuild` | Clean + build |
248
254
  | `bun run clean` | Remove build artifacts |
249
255
  | `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
250
- | `bun run audit:refresh` | Delete `bun.lock`, reinstall, and re-run `bun audit`. Use when `devcheck` flags a transitive advisory — Bun's `update` is sticky on transitive resolutions, so the advisory may be a stale-lockfile false positive. If it survives the refresh, it's real. |
256
+ | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
257
+ | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
251
258
  | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
252
259
  | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
253
260
  | `bun run list-skills` | Print the skill registry |
@@ -265,11 +272,11 @@ When you complete a skill's checklist, check the boxes and add a completion time
265
272
 
266
273
  ## Bundling
267
274
 
268
- `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`node_modules/**` `skills/`, `.claude/`, `.agents/`, `SKILL.md`) that root-anchored `.mcpbignore` patterns cannot reach. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
275
+ `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
269
276
 
270
- **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
277
+ **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
271
278
 
272
- **README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `skills/polish-docs-meta/references/readme.md`.
279
+ **README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `framework-skills/polish-docs-meta/references/readme.md`.
273
280
 
274
281
  ---
275
282
 
@@ -294,12 +301,18 @@ security: false # optional — true ONLY for a source
294
301
 
295
302
  `agent-notes` is an optional free-form field for maintenance agents processing the release downstream. Content here won't appear in the rendered CHANGELOG — it's consumed by agents running the `maintenance` skill. Use it for adoption instructions that don't fit the human-facing sections: new files to create, fields to populate, one-time migration steps. Omit entirely when there's nothing to say.
296
303
 
297
- **Section order** (Keep a Changelog): Added, Changed, Deprecated, Removed, Fixed, Security. Include only sections with entries — don't ship empty headers.
304
+ **Section order:** the Keep a Changelog sequence — Added, Changed, Deprecated, Removed, Fixed, Security — then `Dependencies` last. Include only sections with entries — don't ship empty headers.
298
305
 
299
306
  **Tag annotations** render as GitHub Release bodies via `--notes-from-tag`. They must be structured markdown — never a flat comma-separated string. Subject omits the version number (GitHub prepends it). See `changelog/template.md` for the full format reference.
300
307
 
301
308
  ---
302
309
 
310
+ ## Publishing
311
+
312
+ **Every release goes through a release PR, straight-through** — `git-wrapup`'s "Release PR mode", mode `straight-through`. One run: `git-wrapup` lands the commit stack on `release/<version>`, pushes it, and opens the PR (title = the release commit subject, body = the changelog entry plus a gates section); `release-and-publish` then fast-forwards `main` locally with `git merge --ff-only`, creates the tag on `main`'s tip, pushes `main` and the tag, deletes the branch, and publishes. A caller's brief may run a given release as `gated` instead — a `release-pr-review` pass on the open PR before `release-and-publish`. **Never merge through the GitHub UI or `gh pr merge`**: squash and rebase-merge are disabled in the repo settings because both rewrite the stack (rebase-merge also strips the SSH signatures), and a merge commit breaks the linear history.
313
+
314
+ ---
315
+
303
316
  ## Imports
304
317
 
305
318
  ```ts
@@ -326,7 +339,7 @@ import { getMyService } from '@/services/my-domain/my-service.js';
326
339
  - [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
327
340
  - [ ] Registered in `createApp()` arrays (directly or via barrel exports)
328
341
  - [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
329
- - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = package name; `interface.shortDescription` from `package.json` description
330
- - [ ] `.codex-plugin/mcp.json` updated — server name key matches `package.json` name; env vars added for any required API keys
331
- - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; inline `mcpServers` entry with server name key, env vars for any required API keys
342
+ - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
343
+ - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
344
+ - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
332
345
  - [ ] `npm run devcheck` passes
package/Dockerfile CHANGED
@@ -3,8 +3,11 @@
3
3
  #
4
4
  # This stage installs all dependencies (including dev), builds the TypeScript
5
5
  # source code into JavaScript, and prepares the production assets.
6
+ #
7
+ # The build emits platform-independent JavaScript, so keep this stage native to
8
+ # the builder instead of running Bun under cross-architecture emulation.
6
9
  # ==============================================================================
7
- FROM oven/bun:1.3.14 AS build
10
+ FROM --platform=$BUILDPLATFORM oven/bun:1.4.0 AS build
8
11
 
9
12
  WORKDIR /usr/src/app
10
13
 
@@ -30,7 +33,7 @@ RUN bun run build
30
33
  # application. It uses a slim base image and only includes production
31
34
  # dependencies and build artifacts.
32
35
  # ==============================================================================
33
- FROM oven/bun:1.3.14-slim AS production
36
+ FROM oven/bun:1.4.0-slim AS production
34
37
 
35
38
  WORKDIR /usr/src/app
36
39
 
@@ -52,8 +55,11 @@ COPY package.json bun.lock ./
52
55
 
53
56
  # Install only production dependencies, ignoring any lifecycle scripts (like 'prepare')
54
57
  # that are not needed in the final production image.
58
+ # `--omit=peer` drops the framework's optional peer tiers. Anything this server
59
+ # imports belongs in its own dependencies. The OTEL step carries the same flag
60
+ # so that install does not pull optional peers back into the runtime image.
55
61
  RUN --mount=type=cache,target=/root/.bun/install/cache \
56
- bun install --production --frozen-lockfile --ignore-scripts
62
+ bun install --production --omit=peer --frozen-lockfile --ignore-scripts
57
63
 
58
64
  # Conditionally install OpenTelemetry optional peer dependencies (Tier 3).
59
65
  # These are not bundled by default to keep the base image lean. Enable at build time
@@ -61,7 +67,7 @@ RUN --mount=type=cache,target=/root/.bun/install/cache \
61
67
  ARG OTEL_ENABLED=true
62
68
  RUN --mount=type=cache,target=/root/.bun/install/cache \
63
69
  if [ "$OTEL_ENABLED" = "true" ]; then \
64
- bun add @hono/otel \
70
+ bun add --omit=dev --omit=peer --ignore-scripts @hono/otel \
65
71
  @opentelemetry/instrumentation-http \
66
72
  @opentelemetry/exporter-metrics-otlp-http \
67
73
  @opentelemetry/exporter-trace-otlp-http \
@@ -102,8 +108,7 @@ ENV MCP_FORCE_CONSOLE_LOGGING="true"
102
108
  # Expose the port the server listens on
103
109
  EXPOSE ${MCP_HTTP_PORT}
104
110
 
105
- HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
106
- CMD bun -e "fetch('http://localhost:'+process.env.MCP_HTTP_PORT+'/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
111
+ HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 CMD bun -e "fetch('http://localhost:'+(process.env.MCP_HTTP_PORT??'3010')+'/healthz').then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
107
112
 
108
113
  # The command to start the server
109
114
  CMD ["bun", "run", "dist/index.js"]
package/LICENSE CHANGED
@@ -186,7 +186,7 @@ Apache License
186
186
  same "printed page" as the copyright notice for easier
187
187
  identification within third-party archives.
188
188
 
189
- Copyright 2025 Casey Hand @cyanheads
189
+ Copyright 2026 Casey Hand @cyanheads
190
190
 
191
191
  Licensed under the Apache License, Version 2.0 (the "License");
192
192
  you may not use this file except in compliance with the License.
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.1.11-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/noaa-spaceweather-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/noaa-spaceweather-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/noaa-spaceweather-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.1.13-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/noaa-spaceweather-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/noaa-spaceweather-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/noaa-spaceweather-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -27,9 +27,11 @@
27
27
 
28
28
  ---
29
29
 
30
- ## Tools
30
+ ## Overview
31
31
 
32
- Six tools covering the full NOAA SWPC space weather surface — from a quick status heartbeat to deep solar and geomagnetic data:
32
+ Space weather from NOAA's Space Weather Prediction Center (SWPC) — geomagnetic storm scales, Kp index, aurora forecasts, solar wind, solar activity, and active alerts. Query current conditions, aurora visibility at a coordinate, or windowed plasma and magnetic-field time series from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.
33
+
34
+ ### Tools
33
35
 
34
36
  | Tool | Description |
35
37
  |:-----|:------------|
@@ -40,85 +42,68 @@ Six tools covering the full NOAA SWPC space weather surface — from a quick sta
40
42
  | `noaa_spaceweather_get_solar_activity` | Solar flare picture: GOES X-ray flux, 3-day flare-class probabilities, active solar regions with per-region probabilities, and solar radiation storm level |
41
43
  | `noaa_spaceweather_get_alerts` | Active SWPC alerts, watches, and warnings — structured records with product type, severity, issue time, validity window, and full message text |
42
44
 
43
- ### `noaa_spaceweather_get_conditions`
45
+ ## Capability reference
44
46
 
45
- The heartbeat tool. Use it first — it composes storm scales + current Kp into a single snapshot with a plain-language summary.
47
+ ### `noaa_spaceweather_get_conditions` <sub>tool</sub>
46
48
 
47
- - Returns today's R/S/G storm scales plus a 3-day forecast
49
+ - No inputs — a single call composing storm scales and current Kp into one snapshot
50
+ - Returns today's R/S/G storm scales plus a 3-day forecast series
48
51
  - Current Kp with G-scale equivalent and aurora-visibility latitude guidance
49
- - Plain-language summary: "Quiet conditions" vs. "G2 moderate geomagnetic storm in progress"
50
- - Data sourced from `noaa-scales.json` + `noaa-planetary-k-index.json`
52
+ - Data sourced from the `noaa-scales.json` + `noaa-planetary-k-index.json` feeds
51
53
 
52
54
  ---
53
55
 
54
- ### `noaa_spaceweather_get_kp_index`
55
-
56
- Planetary K-index time series for geomagnetic activity tracking.
56
+ ### `noaa_spaceweather_get_kp_index` <sub>tool</sub>
57
57
 
58
- - `window_days` parameter (1–7, default 1) — recent 3-hour observed values
59
- - Each record includes Kp value, G-scale equivalent, aurora-latitude guidance, and observation time
60
- - Separate 3-day forecast series with predicted Kp and NOAA G-scale labels
58
+ - `window_days` (1–7, default 1) bounds the observed series; the forecast series is always SWPC's full 3-day forecast
59
+ - Each observed/forecast record carries Kp, G-scale equivalent, G-scale label, and aurora-latitude guidance
60
+ - Forecast excludes the feed's embedded historical "observed" entries — only forward-looking `estimated`/`predicted` rows
61
+ - `observedCount` reports how many observed readings matched the window
61
62
 
62
63
  ---
63
64
 
64
- ### `noaa_spaceweather_get_aurora_forecast`
65
+ ### `noaa_spaceweather_get_aurora_forecast` <sub>tool</sub>
65
66
 
66
- OVATION model aurora probability at 1° resolution, updated every ~5 minutes.
67
-
68
- - Without coordinates: global metadata — grid point count, global peak probability, peak region
69
- - With coordinates (`latitude`, `longitude`): nearest-grid-point lookup, minimum Kp required at that latitude, and a plain-language verdict ("Good aurora chance (42%) — Kp≥6 needed at this latitude")
70
- - Covers both hemispheres; coordinates are geographic (WGS84)
67
+ - Without coordinates: global metadata only — grid point count, global peak probability, peak region
68
+ - With `latitude`/`longitude` (WGS84, required together): nearest 1°-grid lookup, minimum Kp needed at that latitude, and a plain-language go/no-go verdict
69
+ - `invalid_coordinates` error when only one of the pair is supplied
70
+ - OVATION model updates every ~5 minutes; forecast horizon is ~30–60 minutes ahead
71
71
 
72
72
  ---
73
73
 
74
- ### `noaa_spaceweather_get_solar_wind`
75
-
76
- Real-time solar wind plasma and magnetic field from SWPC's RTSW feeds.
74
+ ### `noaa_spaceweather_get_solar_wind` <sub>tool</sub>
77
75
 
78
- - Reads the spacecraft SWPC flags as active; every record names its `source`, so no satellite is assumed
79
- - `window_hours` parameter (1–168, default 3) — sliced client-side from a feed that carries roughly the last 24 hours at 1-minute cadence
80
- - Reports `latestFeedPlasmaTime`, `latestFeedMagTime`, and `feedStalenessHours` so an empty window is distinguishable from a stale feed
81
- - Plasma: speed (km/s), proton density (n/cm³), temperature
82
- - Bz component (southward Bz = storm driver) surfaced prominently in output and format
83
- - Bt (total field magnitude) and GSM vector components
76
+ - `window_hours` (1–168, default 3) slices client-side from a feed that carries roughly the last 24 hours at ~1-minute cadence
77
+ - Plasma (speed, density, temperature) and magnetic field (Bx/By/Bz/Bt GSM) returned as separate oldest-first series
78
+ - `bzStatus` surfaces southward Bz (the storm driver) as a plain-language field
79
+ - `latestFeedPlasmaTime`/`latestFeedMagTime`/`feedStalenessHours` distinguish an empty window from a stale feed
80
+ - Every record names its reporting spacecraft — no satellite is assumed as "the" active one
84
81
 
85
82
  ---
86
83
 
87
- ### `noaa_spaceweather_get_solar_activity`
84
+ ### `noaa_spaceweather_get_solar_activity` <sub>tool</sub>
88
85
 
89
- Solar flare and radiation storm picture from GOES and SWPC probabilities.
90
-
91
- - GOES primary X-ray flux in the 0.1–0.8 nm band (R-scale driver)
92
- - 3-day C/M/X flare-class probabilities
93
- - Active solar regions with per-region flare and proton probabilities when `include_regions: true` (default)
94
- - Solar radiation storm (S-scale) level from ≥10 MeV integral proton flux
86
+ - `include_regions` (default true) toggles per-region active-solar-region detail to control response size
87
+ - GOES X-ray flux (0.1–0.8 nm) with flare-class letter (A/B/C/M/X); recent readings cover the past hour
88
+ - 3-day C/M/X flare-class and proton-event probabilities, each duplicated under a legacy `*1Day` name and a date-neutral name
89
+ - Integral proton flux (≥10 MeV) drives the reported NOAA S-scale (0–5)
95
90
 
96
91
  ---
97
92
 
98
- ### `noaa_spaceweather_get_alerts`
99
-
100
- Active SWPC alerts, watches, and warnings from the `products/alerts.json` feed.
93
+ ### `noaa_spaceweather_get_alerts` <sub>tool</sub>
101
94
 
102
- - Structured product metadata: type (Watch/Warning/Alert/Summary), issue time, and ISO 8601 validity window parsed from the message body (`Valid From`/`To`, `Now Valid Until`, or `Begin`/`End Time`)
103
- - Severity read from the NOAA scale stated in the message body (`noaaScale` e.g. `"G1"`, plus `level` 0–5); products stating no scale report level `0`
104
- - Cancellation notices flagged (`cancelled`) and excluded from the active set
105
- - Filtered to active-only by default (`active_only: true`); set `false` for recent history, including cancellations
106
- - Full raw message text preserved for downstream display
95
+ - `active_only` (default true) — in-force Warnings/Watches/Alerts only; cancellations and Summaries excluded
96
+ - `max_age_hours` (1–720, default 48) bounds how far back to look; the SWPC feed itself has no expiry
97
+ - Each record carries product type, NOAA scale + level (0 means "no scale stated," not zero severity), parsed validity window, and full message text
98
+ - `cancelled` flags a record that cancels a prior product rather than being active
107
99
 
108
100
  ---
109
101
 
110
102
  ## Features
111
103
 
112
- Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
113
-
114
- - Declarative tool definitions — single file per tool, framework handles registration and validation
115
- - Unified error handling — handlers throw, framework catches, classifies, and formats
116
- - Pluggable auth: `none`, `jwt`, `oauth`
117
- - Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
118
- - Structured logging with optional OpenTelemetry tracing
119
- - STDIO and Streamable HTTP transports
104
+ Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.
120
105
 
121
- Space weather domain:
106
+ SWPC-specific:
122
107
 
123
108
  - All SWPC feeds are public and keyless — no API keys required
124
109
  - Single `SpaceWeatherService` wraps all six NOAA SWPC JSON feeds with `fetchWithTimeout` + `withRetry`
@@ -257,6 +242,7 @@ cp .env.example .env
257
242
  | `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |
258
243
  | `MCP_HTTP_HOST` | Hostname for HTTP server. | `127.0.0.1` |
259
244
  | `MCP_HTTP_ENDPOINT_PATH` | Endpoint path. | `/mcp` |
245
+ | `MCP_SESSION_MODE` | HTTP session mode. This project explicitly uses `stateless`; `auto` resolves to `stateful`. | `stateless` |
260
246
  | `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |
261
247
  | `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |
262
248
  | `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
@@ -327,7 +313,7 @@ See [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and archit
327
313
 
328
314
  ## Contributing
329
315
 
330
- Issues and pull requests are welcome. Run checks and tests before submitting:
316
+ Issues are welcome. Run checks and tests before submitting:
331
317
 
332
318
  ```sh
333
319
  bun run devcheck
@@ -0,0 +1,27 @@
1
+ ---
2
+ summary: "adopts mcp-ts-core 0.12.3 and the MCP SDK v2 stack, adding modern 2026-07-28 and legacy protocol support, strict tool-input validation, and consistent stateless HTTP serving"
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.12 — 2026-08-25
8
+
9
+ ## Changed
10
+
11
+ - **MCP SDK v2 support** — adopts `@cyanheads/mcp-ts-core` 0.12.3 and the MCP SDK v2 server stack. Streamable HTTP clients can negotiate the modern `2026-07-28` protocol or a 2025-era protocol without changing the server's six-tool surface.
12
+ - **Strict tool inputs** — undeclared fields are now rejected before handler execution and returned as normal MCP tool errors that name the unknown field, instead of being silently stripped.
13
+ - **Explicit stateless HTTP sessions** — `.env.example`, the Docker image, and the README now consistently select stateless mode. STDIO behavior is unchanged.
14
+ - **Current framework scaffold** — refreshes the Bun 1.4 container and package-manager baseline, TypeScript 7 build configuration, MCPB cleanup, release checks, agent skills, and community health files.
15
+
16
+ ## Fixed
17
+
18
+ - **Security contact** — vulnerability reports now route to `security@caseyjhand.com`.
19
+
20
+ ## Dependencies
21
+
22
+ - `@cyanheads/mcp-ts-core` `^0.10.14` → `^0.12.3`
23
+ - `@biomejs/biome` `^2.5.3` → `^2.5.10`
24
+ - `@types/node` `^26.1.1` → `^26.2.0`
25
+ - `tsc-alias` `^1.9.0` → `^1.9.2`
26
+ - `typescript` `^6.0.3` → `^7.0.2`
27
+ - `vitest` `^4.1.10` → `^4.1.11`
@@ -0,0 +1,30 @@
1
+ ---
2
+ summary: "adopts mcp-ts-core 0.13.2 — stateless session default, session-mode server card metadata, argument-rejection structuredContent, Bun 1.4 engines floor"
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.13 — 2026-09-16
8
+
9
+ ## Changed
10
+
11
+ - **`sessionMode: 'stateless'` declared explicitly** in `createApp()` — with `MCP_SESSION_MODE` unset, the server now resolves `stateless` (previously the schema default `auto`, which resolves to `stateful`); an exported `MCP_SESSION_MODE` value still overrides it. The Docker image and `.env.example` already pinned `stateless`, so deployed HTTP behavior is unchanged.
12
+ - **Session mode published on the server card** — `/.well-known/mcp.json` carries it under `_meta` key `io.github.cyanheads.mcp-ts-core/sessionMode`.
13
+ - **Argument rejections now carry `structuredContent.error`** — an undeclared key, wrong type, or missing field returns `structuredContent.error` (code `-32602`, `Invalid arguments for tool …`) alongside the existing text result, `isError: true`.
14
+ - Server identity (name, version, description) resolves from the served package rather than the process working directory.
15
+ - SWPC 500/501 responses now classify as `ServiceUnavailable` rather than `InternalError`; a 500 retries, a 501 does not.
16
+ - An empty string or unsubstituted `${…}` placeholder in a framework `MCP_*` env var now reads as unset.
17
+ - `SIGTERM`/`SIGINT` exit the process explicitly — `0` once shutdown settles, `1` if the 10s ceiling fires.
18
+ - README restructured to an Overview section plus a per-tool capability reference; `.claude-plugin/plugin.json` gains `$schema`, author contact, and keywords; issue forms accept blank issues, link the private security-advisory form, and auto-assign `cyanheads`.
19
+ - Framework skill tree moved from `skills/` to `framework-skills/`, so installing this server's Claude Code or Codex plugin no longer auto-loads its development skills; paths updated across `CLAUDE.md`/`AGENTS.md`, `.mcpbignore`, `.github/CONTRIBUTING.md`, `docs/tree.md`. `## Publishing` section documents the straight-through release PR flow. 28 framework skills updated, `release-pr-review` added, `bun run audit:fix` script added.
20
+
21
+ ## Dependencies
22
+
23
+ - `@cyanheads/mcp-ts-core` `^0.12.3` → `^0.13.2`
24
+ - `zod` `^4.4.3` → `^4.6.4`
25
+ - `@biomejs/biome` `^2.5.10` → `^2.5.13` (dev)
26
+ - `@types/node` `^26.2.0` → `^26.5.1` (dev)
27
+ - `ignore` `^7.0.6` → `^7.0.9` (dev)
28
+ - `tsc-alias` `^1.9.2` → `^1.9.5` (dev)
29
+ - `vitest` `^4.1.11` → `^5.0.0` (dev)
30
+ - Bun engines floor `>=1.3.0` → `>=1.4.0`
@@ -4,10 +4,11 @@
4
4
  # to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
5
5
  # with a concrete date.
6
6
 
7
- # Required. One-line GitHub Release-style headline. 350 character cap.
8
- # Default short and scannable. Don't pad, don't stitch unrelated changes with
9
- # semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
10
- # inside the value as a key separator and fails GitHub's strict parser.
7
+ # Required. One-line GitHub Release-style headline. 350 character cap — a
8
+ # ceiling, not a target. Default short and scannable. Don't pad, don't stitch
9
+ # unrelated changes with commas/semicolons into an inventory — pick the
10
+ # headline, like a tag's theme line. Quotes required: unquoted YAML treats
11
+ # `: ` inside the value as a key separator and fails GitHub's strict parser.
11
12
  summary: ""
12
13
 
13
14
  # Set `true` when consumers must change code to upgrade: API removals,
@@ -24,9 +25,10 @@ security: false
24
25
 
25
26
  # Optional free-form notes for maintenance agents processing this release.
26
27
  # Not rendered in CHANGELOG — consumed by agents running `maintenance` on
27
- # downstream servers. Use for adoption instructions that don't fit the
28
- # human-facing sections: new files to create, fields to populate, one-time
29
- # migration steps. Omit the field entirely when there's nothing to say.
28
+ # downstream servers. ADOPTION STEPS ONLY — new files to create, fields to
29
+ # populate, one-time migration steps. Never a second rendering of the body:
30
+ # if a body bullet already says it, name the bullet's symbol instead of
31
+ # re-explaining. Omit the field entirely when there's nothing to say.
30
32
  # agent-notes: |
31
33
  # <instructions for downstream maintenance agents>
32
34
  ---
@@ -41,17 +43,54 @@ security: false
41
43
  each bullet with the symbol or concept name in **bold** so they can skip
42
44
  what's irrelevant and zoom in on what's not.
43
45
 
44
- Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
45
- name the symbol, state what changed, stop. Use a second sentence only when
46
- it carries weight. If a bullet feels long, it is.
47
-
48
- Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
49
- relevant skill), ceremonial framings ("This release introduces…",
50
- backwards-compat paragraphs), file-by-file test enumerations, internal
51
- implementation notes. Prefer code/symbol names over English re-explanations.
46
+ Tone: terse, fact-dense, not verbose. Bullet shape: **symbol** + what
47
+ changed + at most one consumer-facing caveat. One sentence by default, two
48
+ when the second carries weight — a bullet past ~40 words or three sentences
49
+ is wrong. The depth lives one hop away: the linked issue carries the why,
50
+ the commit diff carries the how. The changelog names what changed and what
51
+ a consumer does about it; a reader who wants mechanism opens the link.
52
+
53
+ Model length on THIS guide, never on the previous entry — entries modeled
54
+ on entries compound.
55
+
56
+ Cut (each has shipped as a wall of text; these are the cruft):
57
+ - History/justification narration — how the bug worked, why the old
58
+ behavior was wrong. One short clause at most; the issue carries the story.
59
+ - Design-rationale defense — "chosen over Y because…", "guarding the
60
+ getter is not enough…". That is the author arguing with a reviewer;
61
+ reviewers read the PR, not the changelog.
62
+ - Defensive unchanged-clauses — "X is unchanged", "byte-identical to
63
+ <prev>". Keep one only where its absence would cause a real misread,
64
+ as a short parenthetical.
65
+ - Edge-case inventories — marker lists, not-flagged lists, escape tables.
66
+ Tests and the issue carry those.
67
+ - Mechanism walkthroughs (JSDoc, CLAUDE.md/AGENTS.md, or the relevant
68
+ skill own those), ceremonial framings ("This release introduces…"),
69
+ backwards-compat paragraphs, file-by-file test enumerations. Prefer
70
+ code/symbol names over English re-explanations.
71
+
72
+ Verified ≠ included: the every-claim-verified-from-the-diff rule bounds
73
+ the TRUTH of what you write, never the AMOUNT.
74
+
75
+ Example — same fact, right size:
76
+
77
+ TOO LONG: **`fetchWithTimeout`'s `timeoutMs` bounds the whole exchange**
78
+ (#341). `fetch` resolves once headers arrive and the deadline was
79
+ cleared as the helper returned, so a peer that answered promptly and
80
+ then stalled the stream held the request open indefinitely. A 2xx
81
+ carrying a body now comes back as a passthrough wrapper that disarms
82
+ the deadline when the body closes, errors, or is cancelled; …
83
+ [+90 more words of mechanism and edge cases]
84
+
85
+ RIGHT: **`fetchWithTimeout`'s `timeoutMs` now bounds the whole
86
+ exchange, not just the headers** (#341). A stalled body aborts with
87
+ the same `Timeout` error; the returned `Response` is a wrapper, so
88
+ identity assertions (`toBe(response)`) no longer hold.
52
89
 
53
90
  Narrative intro: skip by default. Add one short sentence only when the
54
- release theme genuinely needs framing the bullets can't carry.
91
+ release theme genuinely needs framing the bullets can't carry. When many
92
+ bullets share one upgrade consequence, state it ONCE — intro line or
93
+ agent-notes — never per bullet.
55
94
 
56
95
  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
57
96
  Fixed, Security. Include only sections with entries; delete the rest
@@ -78,30 +117,13 @@ security: false
78
117
  in that unrelated item's metadata.
79
118
 
80
119
  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
81
- via `gh release create --notes-from-tag`. The tag is a derivative of this
82
- changelog entry — a condensed, scannable version, not a copy. Format:
83
-
84
- <theme — omit version number, GitHub prepends it>
85
- ← blank line
86
- <1-2 sentence context: what this release does>
87
- ← blank line
88
- Dependency bumps: ← section header
89
- ← blank line
90
- - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6 ← bullet
91
- ← blank line
92
- Changed: ← only sections with entries
93
- ← blank line
94
- - `format()` output includes `query` in text mode
95
- ← blank line
96
- Added:
97
- ← blank line
98
- - `manifest.json` scaffolded for MCPB bundle support
99
- - Install badges (Claude Desktop, Cursor, VS Code)
100
- ← blank line
101
- <N> tests pass; `bun run devcheck` clean. ← footer
102
-
103
- Never a flat comma-separated string. Always structured markdown with
104
- sections. The tag must scan well as a rendered GitHub Release page.
120
+ via `gh release create --notes-from-tag`. It is a condensed digest of this
121
+ entry, never a copy, and its format is owned by the `release-and-publish`
122
+ skill (step 4, "Create the annotated tag"): the entry's `summary:` as the
123
+ theme line without the version, flat headline bullets — no Keep-a-Changelog
124
+ section headers, no gates line — at most one deps line, issue backlinks,
125
+ and the changelog link last. In release-PR mode the `git-wrapup` skill
126
+ authors that digest as the PR body's `## Changes` and the tag copies it.
105
127
  -->
106
128
 
107
129
  ## Added
package/dist/index.js CHANGED
@@ -9,6 +9,7 @@ import { initSpaceWeatherService } from './services/space-weather/space-weather-
9
9
  await createApp({
10
10
  name: 'noaa-spaceweather-mcp-server',
11
11
  title: 'noaa-spaceweather-mcp-server',
12
+ sessionMode: 'stateless',
12
13
  tools: allToolDefinitions,
13
14
  resources: [],
14
15
  prompts: [],
package/dist/index.js.map CHANGED
@@ -1 +1 @@
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,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,8BAA8B;IACrC,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"}
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,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,8BAA8B;IACrC,WAAW,EAAE,WAAW;IACxB,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"}
@@ -12,11 +12,11 @@ export declare const getAlerts: import("@cyanheads/mcp-ts-core").ToolDefinition<
12
12
  productId: z.ZodString;
13
13
  messageCode: z.ZodString;
14
14
  productType: z.ZodEnum<{
15
- Warning: "Warning";
16
- Watch: "Watch";
17
15
  Alert: "Alert";
18
- Summary: "Summary";
19
16
  Other: "Other";
17
+ Summary: "Summary";
18
+ Warning: "Warning";
19
+ Watch: "Watch";
20
20
  }>;
21
21
  level: z.ZodNumber;
22
22
  noaaScale: z.ZodNullable<z.ZodString>;
@@ -20,7 +20,7 @@ function classifyFlare(fluxWm2) {
20
20
  /** Format X-ray flux to 2 significant digits in scientific notation, e.g. 1.4e-6. */
21
21
  function formatFlux(fluxWm2) {
22
22
  // toPrecision gives "1.40e-6" style; strip trailing zeros after decimal for readability.
23
- return fluxWm2.toExponential(1) + ' W/m²';
23
+ return `${fluxWm2.toExponential(1)} W/m²`;
24
24
  }
25
25
  /**
26
26
  * Round integral proton flux to 3 significant figures. Raw GOES values carry
@@ -1 +1 @@
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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"}
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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"}
@@ -2,69 +2,7 @@
2
2
  * @fileoverview Barrel export for all tool definitions.
3
3
  * @module mcp-server/tools/definitions/index
4
4
  */
5
- export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
6
- active_only: import("zod").ZodDefault<import("zod").ZodBoolean>;
7
- max_age_hours: import("zod").ZodDefault<import("zod").ZodNumber>;
8
- }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
9
- alerts: import("zod").ZodArray<import("zod").ZodObject<{
10
- productId: import("zod").ZodString;
11
- messageCode: import("zod").ZodString;
12
- productType: import("zod").ZodEnum<{
13
- Warning: "Warning";
14
- Watch: "Watch";
15
- Alert: "Alert";
16
- Summary: "Summary";
17
- Other: "Other";
18
- }>;
19
- level: import("zod").ZodNumber;
20
- noaaScale: import("zod").ZodNullable<import("zod").ZodString>;
21
- cancelled: import("zod").ZodBoolean;
22
- phenomenon: import("zod").ZodString;
23
- issueDatetime: import("zod").ZodString;
24
- validFrom: import("zod").ZodNullable<import("zod").ZodString>;
25
- validTo: import("zod").ZodNullable<import("zod").ZodString>;
26
- message: import("zod").ZodString;
27
- }, import("zod/v4/core").$strip>>;
28
- totalCount: import("zod").ZodNumber;
29
- fetchedAt: import("zod").ZodString;
30
- }, import("zod/v4/core").$strip>, readonly [{
31
- readonly reason: "feed_unavailable";
32
- readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
33
- readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
34
- readonly retryable: true;
35
- readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
36
- }], {
37
- readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
38
- }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
39
- latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
40
- longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
41
- }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
42
- observationTime: import("zod").ZodString;
43
- forecastTime: import("zod").ZodString;
44
- localLookup: import("zod").ZodNullable<import("zod").ZodObject<{
45
- requestedLatitude: import("zod").ZodNumber;
46
- requestedLongitude: import("zod").ZodNumber;
47
- gridLatitude: import("zod").ZodNumber;
48
- gridLongitude: import("zod").ZodNumber;
49
- auroraPercent: import("zod").ZodNumber;
50
- minKpRequired: import("zod").ZodNumber;
51
- verdict: import("zod").ZodString;
52
- }, import("zod/v4/core").$strip>>;
53
- gridPointCount: import("zod").ZodNumber;
54
- topAuroraPercent: import("zod").ZodNumber;
55
- topAuroraRegion: import("zod").ZodString;
56
- }, import("zod/v4/core").$strip>, readonly [{
57
- readonly reason: "feed_unavailable";
58
- readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
59
- readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
60
- readonly retryable: true;
61
- readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
62
- }, {
63
- readonly reason: "invalid_coordinates";
64
- readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
65
- readonly when: "One coordinate provided without the other.";
66
- readonly recovery: "Provide both latitude and longitude together, or omit both for global metadata only.";
67
- }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
5
+ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
68
6
  observedAt: import("zod").ZodString;
69
7
  currentKp: import("zod").ZodNumber;
70
8
  currentGScale: import("zod").ZodNumber;
@@ -112,6 +50,39 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
112
50
  readonly retryable: true;
113
51
  readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
114
52
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
53
+ active_only: import("zod").ZodDefault<import("zod").ZodBoolean>;
54
+ max_age_hours: import("zod").ZodDefault<import("zod").ZodNumber>;
55
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
56
+ alerts: import("zod").ZodArray<import("zod").ZodObject<{
57
+ productId: import("zod").ZodString;
58
+ messageCode: import("zod").ZodString;
59
+ productType: import("zod").ZodEnum<{
60
+ Alert: "Alert";
61
+ Other: "Other";
62
+ Summary: "Summary";
63
+ Warning: "Warning";
64
+ Watch: "Watch";
65
+ }>;
66
+ level: import("zod").ZodNumber;
67
+ noaaScale: import("zod").ZodNullable<import("zod").ZodString>;
68
+ cancelled: import("zod").ZodBoolean;
69
+ phenomenon: import("zod").ZodString;
70
+ issueDatetime: import("zod").ZodString;
71
+ validFrom: import("zod").ZodNullable<import("zod").ZodString>;
72
+ validTo: import("zod").ZodNullable<import("zod").ZodString>;
73
+ message: import("zod").ZodString;
74
+ }, import("zod/v4/core").$strip>>;
75
+ totalCount: import("zod").ZodNumber;
76
+ fetchedAt: import("zod").ZodString;
77
+ }, import("zod/v4/core").$strip>, readonly [{
78
+ readonly reason: "feed_unavailable";
79
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
80
+ readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
81
+ readonly retryable: true;
82
+ readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
83
+ }], {
84
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
85
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
115
86
  window_days: import("zod").ZodDefault<import("zod").ZodNumber>;
116
87
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
117
88
  observed: import("zod").ZodArray<import("zod").ZodObject<{
@@ -140,6 +111,53 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
140
111
  readonly retryable: true;
141
112
  readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
142
113
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
114
+ window_hours: import("zod").ZodDefault<import("zod").ZodNumber>;
115
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
116
+ plasma: import("zod").ZodArray<import("zod").ZodObject<{
117
+ timeTag: import("zod").ZodString;
118
+ source: import("zod").ZodString;
119
+ densityPerCm3: import("zod").ZodNullable<import("zod").ZodNumber>;
120
+ speedKmS: import("zod").ZodNullable<import("zod").ZodNumber>;
121
+ temperatureK: import("zod").ZodNullable<import("zod").ZodNumber>;
122
+ }, import("zod/v4/core").$strip>>;
123
+ mag: import("zod").ZodArray<import("zod").ZodObject<{
124
+ timeTag: import("zod").ZodString;
125
+ source: import("zod").ZodString;
126
+ bxGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
127
+ byGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
128
+ bzGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
129
+ bt: import("zod").ZodNullable<import("zod").ZodNumber>;
130
+ }, import("zod/v4/core").$strip>>;
131
+ latestPlasma: import("zod").ZodNullable<import("zod").ZodObject<{
132
+ timeTag: import("zod").ZodString;
133
+ source: import("zod").ZodString;
134
+ densityPerCm3: import("zod").ZodNullable<import("zod").ZodNumber>;
135
+ speedKmS: import("zod").ZodNullable<import("zod").ZodNumber>;
136
+ temperatureK: import("zod").ZodNullable<import("zod").ZodNumber>;
137
+ }, import("zod/v4/core").$strip>>;
138
+ latestMag: import("zod").ZodNullable<import("zod").ZodObject<{
139
+ timeTag: import("zod").ZodString;
140
+ source: import("zod").ZodString;
141
+ bxGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
142
+ byGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
143
+ bzGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
144
+ bt: import("zod").ZodNullable<import("zod").ZodNumber>;
145
+ }, import("zod/v4/core").$strip>>;
146
+ bzStatus: import("zod").ZodString;
147
+ plasmaCount: import("zod").ZodNumber;
148
+ magCount: import("zod").ZodNumber;
149
+ latestFeedPlasmaTime: import("zod").ZodNullable<import("zod").ZodString>;
150
+ latestFeedMagTime: import("zod").ZodNullable<import("zod").ZodString>;
151
+ feedStalenessHours: import("zod").ZodNullable<import("zod").ZodNumber>;
152
+ }, import("zod/v4/core").$strip>, readonly [{
153
+ readonly reason: "feed_unavailable";
154
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
155
+ readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
156
+ readonly retryable: true;
157
+ readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
158
+ }], {
159
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
160
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
143
161
  include_regions: import("zod").ZodDefault<import("zod").ZodBoolean>;
144
162
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
145
163
  latestXray: import("zod").ZodNullable<import("zod").ZodObject<{
@@ -194,51 +212,33 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
194
212
  readonly retryable: true;
195
213
  readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
196
214
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
197
- window_hours: import("zod").ZodDefault<import("zod").ZodNumber>;
215
+ latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
216
+ longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
198
217
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
199
- plasma: import("zod").ZodArray<import("zod").ZodObject<{
200
- timeTag: import("zod").ZodString;
201
- source: import("zod").ZodString;
202
- densityPerCm3: import("zod").ZodNullable<import("zod").ZodNumber>;
203
- speedKmS: import("zod").ZodNullable<import("zod").ZodNumber>;
204
- temperatureK: import("zod").ZodNullable<import("zod").ZodNumber>;
205
- }, import("zod/v4/core").$strip>>;
206
- mag: import("zod").ZodArray<import("zod").ZodObject<{
207
- timeTag: import("zod").ZodString;
208
- source: import("zod").ZodString;
209
- bxGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
210
- byGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
211
- bzGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
212
- bt: import("zod").ZodNullable<import("zod").ZodNumber>;
213
- }, import("zod/v4/core").$strip>>;
214
- latestPlasma: import("zod").ZodNullable<import("zod").ZodObject<{
215
- timeTag: import("zod").ZodString;
216
- source: import("zod").ZodString;
217
- densityPerCm3: import("zod").ZodNullable<import("zod").ZodNumber>;
218
- speedKmS: import("zod").ZodNullable<import("zod").ZodNumber>;
219
- temperatureK: import("zod").ZodNullable<import("zod").ZodNumber>;
220
- }, import("zod/v4/core").$strip>>;
221
- latestMag: import("zod").ZodNullable<import("zod").ZodObject<{
222
- timeTag: import("zod").ZodString;
223
- source: import("zod").ZodString;
224
- bxGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
225
- byGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
226
- bzGsm: import("zod").ZodNullable<import("zod").ZodNumber>;
227
- bt: import("zod").ZodNullable<import("zod").ZodNumber>;
218
+ observationTime: import("zod").ZodString;
219
+ forecastTime: import("zod").ZodString;
220
+ localLookup: import("zod").ZodNullable<import("zod").ZodObject<{
221
+ requestedLatitude: import("zod").ZodNumber;
222
+ requestedLongitude: import("zod").ZodNumber;
223
+ gridLatitude: import("zod").ZodNumber;
224
+ gridLongitude: import("zod").ZodNumber;
225
+ auroraPercent: import("zod").ZodNumber;
226
+ minKpRequired: import("zod").ZodNumber;
227
+ verdict: import("zod").ZodString;
228
228
  }, import("zod/v4/core").$strip>>;
229
- bzStatus: import("zod").ZodString;
230
- plasmaCount: import("zod").ZodNumber;
231
- magCount: import("zod").ZodNumber;
232
- latestFeedPlasmaTime: import("zod").ZodNullable<import("zod").ZodString>;
233
- latestFeedMagTime: import("zod").ZodNullable<import("zod").ZodString>;
234
- feedStalenessHours: import("zod").ZodNullable<import("zod").ZodNumber>;
229
+ gridPointCount: import("zod").ZodNumber;
230
+ topAuroraPercent: import("zod").ZodNumber;
231
+ topAuroraRegion: import("zod").ZodString;
235
232
  }, import("zod/v4/core").$strip>, readonly [{
236
233
  readonly reason: "feed_unavailable";
237
234
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
238
235
  readonly when: "SWPC endpoint returns non-OK status or times out after retries.";
239
236
  readonly retryable: true;
240
237
  readonly recovery: "Retry in 30–60 seconds; SWPC feeds occasionally lag during high-activity events.";
241
- }], {
242
- readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
243
- }>)[];
238
+ }, {
239
+ readonly reason: "invalid_coordinates";
240
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
241
+ readonly when: "One coordinate provided without the other.";
242
+ readonly recovery: "Provide both latitude and longitude together, or omit both for global metadata only.";
243
+ }], undefined>)[];
244
244
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAO9B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO9B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"space-weather-service.d.ts","sourceRoot":"","sources":["../../../src/services/space-weather/space-weather-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,cAAc,EAEd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACT,MAAM,YAAY,CAAC;AAqBpB,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO7C;AAkXD,8EAA8E;AAC9E,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAIvB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAMvD,gEAAgE;IAC1D,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAkD1D,uCAAuC;IACjC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoB3D,+BAA+B;IACzB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBxD,qDAAqD;IAC/C,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwBlE;;;;;OAKG;IACG,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAclE;;;;OAIG;IACG,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB5D,kEAAkE;IAC5D,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBpD,mEAAmE;IAC7D,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkC3D,4FAA4F;IACtF,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyCxE,gEAAgE;IAC1D,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBxD,gDAAgD;IAC1C,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CA2C5D;AAMD,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,mBAAmB,CAM5D"}
1
+ {"version":3,"file":"space-weather-service.d.ts","sourceRoot":"","sources":["../../../src/services/space-weather/space-weather-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,cAAc,EAEd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACT,MAAM,YAAY,CAAC;AAqBpB,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO7C;AAkXD,8EAA8E;AAC9E,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAInC,YAAY,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAEtD;IAID,gEAAgE;IAC1D,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA8CzD;IAID,uCAAuC;IACjC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB1D;IAED,+BAA+B;IACzB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvD;IAID,qDAAqD;IAC/C,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoBjE;IAID;;;;;OAKG;IACG,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAYjE;IAED;;;;OAIG;IACG,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAa3D;IAID,kEAAkE;IAC5D,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAcnD;IAED,mEAAmE;IAC7D,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgC1D;IAED,4FAA4F;IACtF,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuCvE;IAED,gEAAgE;IAC1D,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAcvD;IAID,gDAAgD;IAC1C,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0C1D;CACF;AAMD,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,mBAAmB,CAM5D"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/noaa-spaceweather-mcp-server",
3
- "version": "0.1.11",
3
+ "version": "0.1.13",
4
4
  "mcpName": "io.github.cyanheads/noaa-spaceweather-mcp-server",
5
5
  "description": "Query NOAA SWPC space weather: geomagnetic storm scales, Kp index, aurora forecasts, solar wind, solar activity, and alerts via MCP. STDIO or Streamable HTTP.",
6
6
  "type": "module",
@@ -24,6 +24,7 @@
24
24
  "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
25
25
  "clean": "bun run scripts/clean.ts",
26
26
  "devcheck": "bun run scripts/devcheck.ts",
27
+ "audit:fix": "bun audit fix",
27
28
  "audit:refresh": "rm -f bun.lock && bun install && bun audit",
28
29
  "tree": "bun run scripts/tree.ts",
29
30
  "list-skills": "bun run scripts/list-skills.ts",
@@ -31,7 +32,7 @@
31
32
  "format:unsafe": "biome check --write --unsafe .",
32
33
  "lint:mcp": "bun run scripts/lint-mcp.ts",
33
34
  "lint:packaging": "bun run scripts/lint-packaging.ts",
34
- "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/noaa-spaceweather-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/noaa-spaceweather-mcp-server.mcpb",
35
+ "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/noaa-spaceweather-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/noaa-spaceweather-mcp-server.mcpb",
35
36
  "changelog:build": "bun run scripts/build-changelog.ts",
36
37
  "changelog:check": "bun run scripts/build-changelog.ts --check",
37
38
  "release:github": "bun run scripts/release-github.ts",
@@ -80,27 +81,27 @@
80
81
  }
81
82
  ],
82
83
  "license": "Apache-2.0",
83
- "packageManager": "bun@1.3.14",
84
+ "packageManager": "bun@1.4.0",
84
85
  "engines": {
85
- "bun": ">=1.3.0",
86
+ "bun": ">=1.4.0",
86
87
  "node": ">=24.0.0"
87
88
  },
88
89
  "publishConfig": {
89
90
  "access": "public"
90
91
  },
91
92
  "dependencies": {
92
- "@cyanheads/mcp-ts-core": "^0.10.14",
93
+ "@cyanheads/mcp-ts-core": "^0.13.2",
93
94
  "pino-pretty": "^13.1.3",
94
- "zod": "^4.4.3"
95
+ "zod": "^4.6.4"
95
96
  },
96
97
  "devDependencies": {
97
- "@biomejs/biome": "^2.5.3",
98
+ "@biomejs/biome": "^2.5.13",
98
99
  "@socketsecurity/bun-security-scanner": "^1.1.2",
99
- "@types/node": "^26.1.1",
100
+ "@types/node": "^26.5.1",
100
101
  "depcheck": "^1.4.7",
101
- "ignore": "^7.0.6",
102
- "tsc-alias": "^1.9.0",
103
- "typescript": "^6.0.3",
104
- "vitest": "^4.1.10"
102
+ "ignore": "^7.0.9",
103
+ "tsc-alias": "^1.9.5",
104
+ "typescript": "^7.0.2",
105
+ "vitest": "^5.0.0"
105
106
  }
106
107
  }
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/cyanheads/noaa-spaceweather-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.11",
9
+ "version": "0.1.13",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
@@ -19,7 +19,7 @@
19
19
  "registryBaseUrl": "https://registry.npmjs.org",
20
20
  "identifier": "@cyanheads/noaa-spaceweather-mcp-server",
21
21
  "runtimeHint": "bun",
22
- "version": "0.1.11",
22
+ "version": "0.1.13",
23
23
  "packageArguments": [
24
24
  {
25
25
  "type": "positional",
@@ -48,7 +48,7 @@
48
48
  "registryBaseUrl": "https://registry.npmjs.org",
49
49
  "identifier": "@cyanheads/noaa-spaceweather-mcp-server",
50
50
  "runtimeHint": "bun",
51
- "version": "0.1.11",
51
+ "version": "0.1.13",
52
52
  "packageArguments": [
53
53
  {
54
54
  "type": "positional",