@openephemeris/mcp-server 3.5.0 → 3.5.2

package/CHANGELOG.md

@@ -7,6 +7,15 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [3.5.1] — 2026-03-31
+
+### Changed
+- Added `mcp-server`, `modelcontextprotocol`, `model-context-protocol` to package.json keywords for registry discovery
+- Fixed `OE_API_KEY` → `OPENEPHEMERIS_API_KEY` in registry submission guide
+- Corrected GitHub links from `MeridianMap` to `Spirit-River` org
+
+---
+
 ## [3.5.0] — 2026-03-28
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # 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/)
+[![System Status](https://img.shields.io/badge/Status-Operational-brightgreen)](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.
 
@@ -86,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
 
@@ -179,17 +224,17 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- 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`
+- Allowlisted operations: **22**
+- Methods: `GET=4`, `POST=18`, `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
 
 | Family | Operations | Example |
 |---|---:|---|
-| `acg` | 2 | `POST /acg/ccg`, `POST /acg/power-lines` |
+| `acg` | 4 | `POST /acg/ccg`, `POST /acg/hits` |
 | `comparative` | 5 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
 | `electional` | 4 | `GET /electional/aspect-search`, `GET /electional/find-window` |
 | `ephemeris` | 1 | `POST /ephemeris/relocation` |

package/config/dev-allowlist.json

@@ -19,6 +19,14 @@
       "method": "POST",
       "path": "/acg/ccg"
     },
+    {
+      "method": "POST",
+      "path": "/acg/hits"
+    },
+    {
+      "method": "POST",
+      "path": "/acg/local-space"
+    },
     {
       "method": "POST",
       "path": "/acg/power-lines"
@@ -96,8 +104,8 @@
       "path": "/visualization/chart-wheel"
     }
   ],
-  "last_generated_at": "2026-03-28T17:28:53.352Z",
-  "openapi_sha256": "cb3161103c61dfa063dcfed946f96ecf6c1df3c9f6c5d20378b54583d70d2f75",
+  "last_generated_at": "2026-04-02T14:37:22.841Z",
+  "openapi_sha256": "fd75c2b6eae40884622067c1489e61a2d35b9cce9cd57943e989210a6728a197",
   "candidates_get": [
     {
       "method": "GET",
@@ -469,6 +477,14 @@
       ],
       "operationId": "features_acg_features_post"
     },
+    {
+      "method": "POST",
+      "path": "/acg/heatmap/composite",
+      "tags": [
+        "Astrocartography"
+      ],
+      "operationId": "AcgHeatmapCompositeAcgHeatmapCompositePost"
+    },
     {
       "method": "POST",
       "path": "/acg/hermetic-lines",
@@ -971,6 +987,8 @@
     "errors": [],
     "warnings": [
       "Non-GET allowlisted: POST /acg/ccg",
+      "Non-GET allowlisted: POST /acg/hits",
+      "Non-GET allowlisted: POST /acg/local-space",
       "Non-GET allowlisted: POST /acg/power-lines",
       "Non-GET allowlisted: POST /comparative/composite/midpoint",
       "Non-GET allowlisted: POST /comparative/composite",

package/dist/server-sse.js

@@ -144,7 +144,7 @@ async function main() {
     app.use((_req, res, next) => {
         res.setHeader("Access-Control-Allow-Origin", "*");
         res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-API-Key, X-Meridian-API-Key");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-API-Key, X-OpenEphemeris-API-Key");
         if (_req.method === "OPTIONS") {
             res.status(204).end();
             return;
@@ -190,7 +190,7 @@ async function main() {
         // Extract API key from query param or header
         const apiKey = req.query.apiKey ||
             req.headers["x-api-key"] ||
-            req.headers["x-meridian-api-key"] ||
+            req.headers["x-openephemeris-api-key"] ||
             req.headers["authorization"]?.replace(/^Bearer\s+/i, "");
         if (!apiKey) {
             res.status(401).json({

package/dist/tools/dev.js

@@ -165,6 +165,12 @@ registerTool({
                 query.format = "llm";
             }
         }
+        // Auto-inject format=png for visualization endpoints when no format specified.
+        // MCP image handlers only accept PNG/JPG/GIF/WEBP — SVG won't render inline.
+        const isVisualizationPath = pathname.startsWith("/visualization/") || pathname.startsWith("/comparative/visualization/");
+        if (isVisualizationPath && !query.format) {
+            query.format = "png";
+        }
         return await backendClient.request(method, pathname, {
             params: query,
             data: body,

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.5.0",
+  "version": "3.5.2",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -42,6 +42,9 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
+    "modelcontextprotocol",
+    "model-context-protocol",
     "astrology",
     "astronomy",
     "ephemeris",
@@ -52,22 +55,27 @@
     "swiss ephemeris"
   ],
   "author": "Open Ephemeris",
+  "homepage": "https://openephemeris.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Spirit-River/openephemeris-MCP.git"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.3",
-    "axios": "^1.13.2",
-    "express": "^5.1.0",
-    "zod": "^4.1.13"
+    "@modelcontextprotocol/sdk": "1.24.3",
+    "axios": "1.13.2",
+    "express": "5.1.0",
+    "zod": "4.1.13"
   },
   "devDependencies": {
-    "@types/express": "^5.0.3",
-    "@types/node": "^25.0.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "@types/express": "5.0.3",
+    "@types/node": "25.0.1",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15"
   },
   "packageManager": "pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a"
 }