@openephemeris/mcp-server 3.4.2 → 3.5.1

package/CHANGELOG.md

@@ -7,8 +7,22 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [3.5.0] — 2026-03-28
+
+### Added
+- `POST /ephemeris/draconic` — Draconic chart: full planetary set shifted to True Node as 0° Aries (Explorer tier, 1 credit)
+- `POST /ephemeris/prenatal-lunation` — Finds the prenatal new and full moon preceding a subject's birth date (Developer tier, 5 credits)
+- `POST /predictive/primary-directions` — Placidian semi-arc primary directions with configurable arc length and body/angle targets (Developer tier, 5 credits)
+
+### Changed
+- Total production endpoints: **107 → 110**
+- `dev-allowlist.json`, `endpoint-tier-matrix.json`, `llms.txt` all updated to reflect new surface
+
+---
+
 ## [3.4.1] — 2026-03-25
 
+
 ### Fixed
 - Chiron position fallback for edge-date calculations now uses full Swiss Ephemeris path instead of simplified approximation
 - SSE server chart wheel responses now correctly deliver native MCP image blocks instead of raw base64 JSON

package/README.md

@@ -1,5 +1,7 @@
 # OpenEphemeris MCP Server
 
+[![System Status](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fblacksmithops%2Fbetter-stack-shields%2Fmain%2Fbetterstack.json&label=Status&color=success)](https://status.openephemeris.com/)
+
 Model Context Protocol server for OpenEphemeris. This package exposes typed astrology tools and an allowlist-gated generic proxy (`dev.call`) for MCP-compatible clients.
 
 ## Quick Start
@@ -84,12 +86,57 @@ This package runs as a local stdio MCP server. Remote-only clients require a hos
 
 ## What You Can Ask
 
-- "Calculate a natal chart for 1990-04-15 14:30 in Chicago."
-- "Find transit events for the next 6 months."
-- "Get moon phase and void-of-course status right now."
-- "Find an electional window for signing a contract next month."
-- "Generate Human Design chart data from birth details."
-- "Call `/predictive/transits/search` with `format=llm`."
+```
+"Calculate a natal chart for 1990-04-15 at 2:30 PM in Chicago."
+"Find all Saturn transits to my natal Sun in the next 6 months."
+"Get the current moon phase and void-of-course status."
+"Find the next solar eclipse visible from Tokyo."
+"Find the best time to sign a contract in March — electional window."
+"Generate a Human Design chart for my birth data."
+"What is my Vedic (sidereal) chart?"
+"Calculate my Chinese BaZi (Four Pillars) chart."
+"Show me my Astrocartography power lines — where is my Venus line on the map?"
+"Find all ACG lines within 3° of Paris for my chart."
+"Calculate a synastry chart between two people."
+"Find the next Venus Star Point and my relationship to it."
+"What are the active planetary stations in the next 3 months?"
+"Calculate primary directions for the next 5 years."
+"Find my Firdaria time lord period."
+"What is the sidereal time and delta-T right now?"
+```
+
+## Tools at a Glance
+
+| Category | Tool | Tier |
+|---|---|---|
+| Natal chart | `ephemeris_natal_chart` | Explorer |
+| Transit forecast | `ephemeris_transits` | Personal |
+| Transit chart snapshot | `ephemeris_natal_transits` | Personal |
+| Moon phase / VOC | `ephemeris_moon_phase` | Explorer |
+| Eclipse next visible | `ephemeris_next_eclipse` | Explorer |
+| Electional window | `ephemeris_electional` | Developer |
+| Moment analysis | `electional_moment_analysis` | Developer |
+| Station tracker | `electional_station_tracker` | Developer |
+| Aspect search | `electional_aspect_search` | Developer |
+| Human Design chart | `human_design_chart` | Explorer |
+| HD composite | `human_design_composite` | Explorer |
+| HD penta | `human_design_penta` | Explorer |
+| HD return / opposition | `hd_planetary_return`, `hd_opposition` | Explorer |
+| Vedic chart | `vedic_chart` | Explorer |
+| BaZi (Chinese) | `chinese_bazi` | Explorer |
+| Synastry | `ephemeris_synastry` | Developer |
+| Composite chart | `ephemeris_composite` | Developer |
+| Relocation chart | `ephemeris_relocation` | Developer |
+| Progressed chart | `ephemeris_progressed_chart` | Explorer |
+| Solar return | `ephemeris_solar_return` | Developer |
+| Lunar return | `ephemeris_lunar_return` | Developer |
+| Planetary return | `ephemeris_planetary_return` | Developer |
+| Astrocartography lines | `acg_power_lines` | Developer |
+| ACG hits at location | `acg_hits` | Scale |
+| Venus Star Points | `venus_star_points` + 4 more | Explorer |
+| Chart wheel image | `ephemeris_chart_wheel` | Developer |
+| Bi-wheel image | `ephemeris_bi_wheel` | Developer |
+| Dignities / Midpoints / Fixed stars | `ephemeris_dignities`, `ephemeris_midpoints`, `ephemeris_fixed_stars` | Explorer |
 
 ## Tooling Model
 
@@ -177,10 +224,10 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **17**
-- Methods: `GET=4`, `POST=13`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **50**
-- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `hd_opposition`, `hd_planetary_return`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
+- Allowlisted operations: **20**
+- Methods: `GET=4`, `POST=16`, `PUT=0`, `PATCH=0`, `DELETE=0`
+- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **48**
+- Typed tools: `auth_login`, `auth_logout`, `auth_status`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `hd_opposition`, `hd_planetary_return`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
 - Generic tools: 
 
 ### Allowlist Families
@@ -191,7 +238,7 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 | `comparative` | 5 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
 | `electional` | 4 | `GET /electional/aspect-search`, `GET /electional/find-window` |
 | `ephemeris` | 1 | `POST /ephemeris/relocation` |
-| `predictive` | 3 | `POST /predictive/returns`, `POST /predictive/returns/lunar` |
+| `predictive` | 6 | `POST /predictive/returns`, `POST /predictive/returns/lunar` |
 | `visualization` | 2 | `POST /visualization/bi-wheel`, `POST /visualization/chart-wheel` |
 <!-- GENERATED:RUNTIME_SNAPSHOT:END -->
 

package/config/dev-allowlist.json

@@ -75,6 +75,18 @@
       "method": "POST",
       "path": "/predictive/returns"
     },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/firdaria"
+    },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/profections"
+    },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/zodiacal-releasing"
+    },
     {
       "method": "POST",
       "path": "/visualization/bi-wheel"
@@ -84,8 +96,8 @@
       "path": "/visualization/chart-wheel"
     }
   ],
-  "last_generated_at": "2026-03-25T15:51:37.919Z",
-  "openapi_sha256": "48a3d6db42a5957421c3c7b3a5af3f971df36a2558bce7a13943ad097dfe3621",
+  "last_generated_at": "2026-03-29T02:31:11.230Z",
+  "openapi_sha256": "c92376455af5f33481fd676a126d9b9436b30d5dd0c681d33258cf74a19ba18b",
   "candidates_get": [
     {
       "method": "GET",
@@ -553,6 +565,14 @@
       ],
       "operationId": "angles_points_ephemeris_angles_points_post"
     },
+    {
+      "method": "POST",
+      "path": "/ephemeris/antiscia",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "calculate_antiscia_ephemeris_antiscia_post"
+    },
     {
       "method": "POST",
       "path": "/ephemeris/aspect-check",
@@ -561,6 +581,14 @@
       ],
       "operationId": "aspect_check_ephemeris_aspect_check_post"
     },
+    {
+      "method": "POST",
+      "path": "/ephemeris/declinations",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "analyze_declinations_ephemeris_declinations_post"
+    },
     {
       "method": "POST",
       "path": "/ephemeris/dignities",
@@ -569,6 +597,22 @@
       ],
       "operationId": "dignities_ephemeris_dignities_post"
     },
+    {
+      "method": "POST",
+      "path": "/ephemeris/dispositor-tree",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "calculate_dispositor_tree_ephemeris_dispositor_tree_post"
+    },
+    {
+      "method": "POST",
+      "path": "/ephemeris/draconic",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "calculate_draconic_chart_ephemeris_draconic_post"
+    },
     {
       "method": "POST",
       "path": "/ephemeris/fixed-stars",
@@ -577,6 +621,22 @@
       ],
       "operationId": "calculate_fixed_stars_ephemeris_fixed_stars_post"
     },
+    {
+      "method": "POST",
+      "path": "/ephemeris/harmonics",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "calculate_harmonics_ephemeris_harmonics_post"
+    },
+    {
+      "method": "POST",
+      "path": "/ephemeris/heatmap/score",
+      "tags": [
+        "Ephemeris"
+      ],
+      "operationId": "HeatmapScoreEphemerisHeatmapScorePost"
+    },
     {
       "method": "POST",
       "path": "/ephemeris/hermetic-lots",
@@ -633,6 +693,14 @@
       ],
       "operationId": "planet_position_ephemeris_planet_position_post"
     },
+    {
+      "method": "POST",
+      "path": "/ephemeris/prenatal-lunation",
+      "tags": [
+        "ephemeris"
+      ],
+      "operationId": "calculate_prenatal_lunation_ephemeris_prenatal_lunation_post"
+    },
     {
       "method": "POST",
       "path": "/ephemeris/progressed",
@@ -761,6 +829,14 @@
       ],
       "operationId": "human_design_transit_human_design_transit_post"
     },
+    {
+      "method": "POST",
+      "path": "/predictive/primary-directions",
+      "tags": [
+        "predictive"
+      ],
+      "operationId": "CalculatePrimaryDirections"
+    },
     {
       "method": "POST",
       "path": "/predictive/returns/lunar",
@@ -785,6 +861,30 @@
       ],
       "operationId": "calculate_planetary_return_predictive_returns_post"
     },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/firdaria",
+      "tags": [
+        "predictive"
+      ],
+      "operationId": "calculate_firdaria_predictive_time_lords_firdaria_post"
+    },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/profections",
+      "tags": [
+        "predictive"
+      ],
+      "operationId": "calculate_profections_predictive_time_lords_profections_post"
+    },
+    {
+      "method": "POST",
+      "path": "/predictive/time-lords/zodiacal-releasing",
+      "tags": [
+        "predictive"
+      ],
+      "operationId": "calculate_zodiacal_releasing_predictive_time_lords_zodiacal_releasing_post"
+    },
     {
       "method": "POST",
       "path": "/predictive/transit-chart",
@@ -889,6 +989,9 @@
       "Non-GET allowlisted: POST /predictive/returns/lunar",
       "Non-GET allowlisted: POST /predictive/returns/solar",
       "Non-GET allowlisted: POST /predictive/returns",
+      "Non-GET allowlisted: POST /predictive/time-lords/firdaria",
+      "Non-GET allowlisted: POST /predictive/time-lords/profections",
+      "Non-GET allowlisted: POST /predictive/time-lords/zodiacal-releasing",
       "Non-GET allowlisted: POST /visualization/bi-wheel",
       "Non-GET allowlisted: POST /visualization/chart-wheel"
     ]

package/dist/tools/index.js

@@ -36,7 +36,6 @@ export async function initTools(profile) {
         await import("./specialized/returns.js");
         await import("./specialized/progressed.js");
         await import("./specialized/ephemeris_core.js");
-        await import("./specialized/acg.js");
         await import("./specialized/comparative.js");
         await import("./specialized/hd_group.js");
         await import("./specialized/hd_cycles.js");

package/package.json

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