@openephemeris/mcp-server 3.4.1 → 3.5.0

package/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+All notable changes to `@openephemeris/mcp-server` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+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
+
+### Changed
+- Explorer tier daily cap set to 50 credits/day (resets midnight UTC)
+- Catalog and metadata endpoints (`/acg/meta`, `/acg/datasets`, `/catalogs/*`) moved to free tier (0 credits)
+
+---
+
+## [3.4.0] — 2026-03-22
+
+### Added
+- `hd_planetary_return` tool — finds the exact date when a planet returns to its natal position in HD context
+- `hd_opposition` tool — finds the exact date/age of a planet's first opposition (age cycle milestone)
+- `venus_star_points`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_stations` — complete Venus Star Point toolkit
+- `ephemeris_planetary_return` — generic multi-planet support for solar, lunar, and outer planet returns
+- `ephemeris_lunar_return` — dedicated monthly lunar return chart
+
+### Changed
+- Asteroid data (Chiron, Ceres, Pallas, Juno, Vesta, Pholus) now included by default in natal chart responses
+- `ephemeris_transits` tool now includes explicit `aspect_angle` parameter with examples for returns and oppositions
+
+---
+
+## [3.3.0] — 2026-03-21
+
+### Added
+- Timezone parameter added to all natal/transit/predictive tools — resolves ambiguous local-time inputs
+- `ephemeris_composite_midpoint` — Davison midpoint composite chart
+- `ephemeris_fixed_stars` — Ptolemaic fixed star positions with orb and conjunction data
+- `ephemeris_hermetic_lots` — Arabic parts / Hermetic Lots (Lot of Fortune, Spirit, etc.)
+
+### Fixed
+- ACG power lines now correctly render for southern hemisphere birth locations
+- Timezone resolution for "America/Denver" and similar IANA names no longer defaults to UTC
+
+---
+
+## [3.2.0] — 2026-03-21
+
+### Added
+- SSE (Server-Sent Events) transport support — enables remote MCP clients without local `npx` installs
+- `ephemeris_chart_wheel` and `ephemeris_bi_wheel` tools now deliver native MCP image blocks (PNG)
+- Payload size safety cap — responses over 500kb return a structured `PAYLOAD_TOO_LARGE` error
+
+### Fixed
+- Composite chart endpoint route corrected in allowlist
+
+---
+
+## [3.1.0] — 2026-03-20
+
+### Added
+- `human_design_composite` — dual-chart BodyGraph overlay for relationship analysis
+- `human_design_penta` — 5-person Penta composite for group/team dynamics
+- `ephemeris_progressed_chart` — secondary progressions (day-for-a-year method)
+
+### Changed
+- Personal tier: 1,500 credits/month (formerly 'Maker' at 750)
+- Startup tier: 15,000 credits/month (formerly 'Pro')
+- Developer tier: 75,000 credits/month
+
+---
+
+## [3.0.0] — 2026-03-15
+
+### Added
+- Full tool allowlist security model — default-deny with `config/dev-allowlist.json`
+- `dev.call` and `dev.list_allowed` generic proxy tools for allowlisted operations
+- `welcome_to_open_ephemeris` MCP Prompt — orientation guide available to MCP clients
+- Server icon registered at `https://mcp.openephemeris.com/icon.png`
+- `verify:release` npm gate script for pre-publish validation
+
+### Breaking
+- Environment variable renamed from `ASTROMCP_API_KEY` to `OPENEPHEMERIS_API_KEY` (old name kept as fallback)
+- Package renamed from `@astromcp/server` to `@openephemeris/mcp-server`
+
+---
+
+## [2.x] — Legacy
+
+Earlier versions published under `@astromcp/server`. All users should migrate to `@openephemeris/mcp-server`.
+
+---
+
+*[Unreleased changes are tracked in commit history.]*

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Open Ephemeris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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
@@ -177,8 +179,8 @@ 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`
+- Allowlisted operations: **20**
+- Methods: `GET=4`, `POST=16`, `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`
 - Generic tools: 
@@ -191,7 +193,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-28T17:28:53.352Z",
+  "openapi_sha256": "cb3161103c61dfa063dcfed946f96ecf6c1df3c9f6c5d20378b54583d70d2f75",
   "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,14 @@
       ],
       "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/hermetic-lots",
@@ -633,6 +685,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 +821,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 +853,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 +981,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/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
   "files": [
     "dist",
     "config/dev-allowlist.json",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "bin": {
     "openephemeris-mcp": "dist/index.js"