@openephemeris/mcp-server 4.13.0 → 4.14.0

package/CHANGELOG.md

@@ -7,6 +7,36 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [4.14.0] — 2026-08-27
+
+### Added
+- **Fixed stars on `ephemeris_natal_chart` — for real this time.** The
+  `include_fixed_stars` flag removed in 4.13.0 returns, honest now: the API
+  wires it as of the 2026-08-27 release, so asking adds a `fixed_stars` block
+  with star positions and conjunctions against the chart's bodies and angles,
+  computed in the same zodiac frame as the chart (a sidereal chart's star hits
+  equal the tropical chart's, by construction and by test). 4.13.0 removed the
+  flag because it did nothing; 4.14.0 restores it because it does something.
+
+- **`declinations` on `ephemeris_natal_chart`.** One flag adds each body's
+  declination and out-of-bounds status, plus parallel and contraparallel
+  aspects at a 1.5° orb.
+
+- **`solar_relationships` on `ephemeris_natal_chart`.** Combustion, cazimi
+  and under-beams classification for Moon through Saturn; outer bodies get
+  the geometry without a verdict.
+
+### Changed
+- The REST API these tools call also gained, in the same server release:
+  birthplace names echoed back (`birth_location.location_name`), hermetic-lot
+  suite selection, and provenance metadata on every response
+  (`ephemeris_version`, `delta_t_source`, `delta_t_seconds`,
+  `coordinate_reference_frame`, `time_scale`). These need no new tool
+  parameters — the metadata simply appears in responses, and lot selection is
+  reachable through the request-body pass-through paths.
+
+---
+
 ## [4.13.0] — 2026-08-27
 
 ### Added

package/dist/tools/specialized/natal.js

@@ -92,6 +92,20 @@ registerTool({
                     "grid. Off by default; minors use their own orbs, so this widens the grid without changing " +
                     "any major aspect.",
             },
+            include_fixed_stars: {
+                type: "boolean",
+                description: "Add fixed-star conjunctions (Regulus, Algol, Spica and the catalog) against the chart's " +
+                    "bodies and angles. Honoured by the endpoint since 4.14.0; same zodiac frame as the chart.",
+            },
+            declinations: {
+                type: "boolean",
+                description: "Add each body's declination and out-of-bounds flag, plus parallel/contraparallel aspects " +
+                    "(1.5° orb).",
+            },
+            solar_relationships: {
+                type: "boolean",
+                description: "Classify combustion, cazimi and under-beams for Moon–Saturn relative to the Sun.",
+            },
             include_visual: {
                 type: "boolean",
                 description: "When true, renders the natal chart wheel as an SVG and embeds it directly in the response. " +
@@ -182,6 +196,29 @@ registerTool({
                 include_hermetic_lots: true,
             };
         }
+        // All three below were ghost parameters until the 2026-08-27 fan-out
+        // (#719) wired them server-side; they are exposed here only because the
+        // endpoint now actually reads them.
+        if (args.include_fixed_stars) {
+            body.configuration = {
+                ...(body.configuration || {}),
+                fixed_star_options: { include: true },
+            };
+        }
+        if (args.declinations) {
+            body.options = {
+                ...body.options,
+                include_declination_values: true,
+                include_declination_aspects: true,
+                include_out_of_bounds: true,
+            };
+        }
+        if (args.solar_relationships) {
+            body.enhanced_options = {
+                ...(body.enhanced_options || {}),
+                solar_relationships: true,
+            };
+        }
         const query = {};
         if (args.format)
             query.format = args.format;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "4.13.0",
+  "version": "4.14.0",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",