@openephemeris/mcp-server 4.14.3 → 4.15.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [4.15.0] — 2026-09-03
+
+### Added
+- **`electional_angle_crossings` gains `natal_datetime`.** Pass a zoned natal instant and the search
+  finds when the **secondary-progressed** positions of Sun, Moon, Mercury, Venus, Mars and the lunar
+  nodes reach an angle at the place — the same body set and day-for-a-year formula the hybrid CCG
+  transit map draws with — while slower bodies stay transits. Progressed crossings carry
+  `progressed: true` and `search_summary.progression` names the mode, the natal instant and the
+  bodies progressed. Omit the parameter for the plain transit search, which is unchanged.
+
 ## [4.14.3] — 2026-09-02
 
 ### Fixed

package/dist/tools/specialized/electional.js

@@ -1,7 +1,7 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
-import { WINDOW_DATE_DESC } from "../datetime.js";
+import { DATETIME_DESC, WINDOW_DATE_DESC, localToUtcIso, timezoneProperty } from "../datetime.js";
 // All electional endpoints are GET endpoints with query params.
 // GET /electional/find-window — already existed, keeping it
 registerTool({
@@ -279,6 +279,10 @@ registerTool({
         "Crossing times use the same in-mundo geometry as the astrocartography line engine, so casting a " +
         "map at a returned moment puts that line through the query point. Circumpolar cases (a body that " +
         "never rises or never sets at that latitude) simply return no event.\n\n" +
+        "PROGRESSED (hybrid) lines: pass natal_datetime to search the SECONDARY-PROGRESSED positions of " +
+        "Sun, Moon, Mercury, Venus, Mars and the lunar nodes — the same body set and formula the CCG hybrid " +
+        "transit map (/acg/ccg mode=ccg_hybrid) draws with; every other body stays a transit. Progressed " +
+        "crossings carry progressed: true and search_summary.progression names what was progressed.\n\n" +
         "CREDIT COST: 5 credits per call.\n\n" +
         "EXAMPLE: When does Mercury cross the Descendant over Warsaw on 2026-07-30?\n" +
         "  latitude=52.2297, longitude=21.0122, bodies='Mercury', angles='DC',\n" +
@@ -320,6 +324,14 @@ registerTool({
                 type: "number",
                 description: "Maximum number of crossing events to return (default 5000).",
             },
+            natal_datetime: {
+                type: "string",
+                description: "Optional natal (birth) instant. When given, Sun, Moon, Mercury, Venus, Mars and the lunar " +
+                    "nodes are secondary-progressed from it (day-for-a-year) and the search finds when their " +
+                    "PROGRESSED position reaches the angle — the line a hybrid CCG map paints. Slow bodies " +
+                    "(Jupiter outward) are unaffected. Omit for the plain transit search. " + DATETIME_DESC,
+            },
+            natal_timezone: timezoneProperty("the natal birth location", "Europe/London"),
             format: {
                 type: "string",
                 enum: ["json", "llm"],
@@ -349,6 +361,11 @@ registerTool({
             query.refraction_correction = args.refraction_correction;
         if (args.max_results !== undefined)
             query.max_results = args.max_results;
+        // A naive birth time plus its zone is a legitimate call (the datetime
+        // contract); the API's GET takes one zoned instant, so resolve here.
+        if (args.natal_datetime) {
+            query.natal_datetime = localToUtcIso("natal_datetime", args.natal_datetime, args.natal_timezone, "natal_timezone");
+        }
         if (args.format)
             query.format = args.format;
         return await getActiveClient().request("GET", "/electional/angle-crossings", {

package/package.json

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