@openephemeris/mcp-server 3.4.0 → 3.4.1

package/README.md

@@ -177,32 +177,21 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **97**
-- Methods: `GET=41`, `POST=56`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **49**
-- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_ingress_calendar`, `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`, `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: **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`
 - Generic tools: 
 
 ### Allowlist Families
 
 | Family | Operations | Example |
 |---|---:|---|
-| `acg` | 12 | `POST /acg/aspects`, `POST /acg/ccg` |
-| `calendar` | 3 | `GET /calendar/astrology/cross-quarter`, `GET /calendar/astrology/lunar-standstill` |
-| `catalogs` | 3 | `GET /catalogs/bodies`, `GET /catalogs/fixed-stars` |
-| `chinese` | 2 | `POST /chinese/bazi`, `GET /chinese/zodiac` |
+| `acg` | 2 | `POST /acg/ccg`, `POST /acg/power-lines` |
 | `comparative` | 5 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
-| `eclipse` | 5 | `GET /eclipse/besselian-elements`, `GET /eclipse/lunar/global` |
-| `electional` | 5 | `GET /electional/aspect-search`, `GET /electional/find-window` |
-| `ephemeris` | 33 | `GET /ephemeris/agro/calendar`, `GET /ephemeris/agro/daily` |
-| `health` | 1 | `GET /health` |
-| `human-design` | 5 | `POST /human-design/chart`, `POST /human-design/composite` |
-| `location` | 2 | `GET /location/autocomplete`, `GET /location/reverse` |
-| `predictive` | 8 | `POST /predictive/events`, `POST /predictive/returns` |
-| `tidal` | 2 | `GET /tidal/forcing`, `GET /tidal/forcing/deep-time` |
-| `time` | 6 | `GET /time/delta-t`, `GET /time/equation-of-time` |
-| `timezone` | 2 | `POST /timezone/lookup`, `POST /timezone/offset` |
-| `vedic` | 1 | `POST /vedic/chart` |
+| `electional` | 4 | `GET /electional/aspect-search`, `GET /electional/find-window` |
+| `ephemeris` | 1 | `POST /ephemeris/relocation` |
+| `predictive` | 3 | `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

@@ -15,94 +15,22 @@
     ]
   },
   "allow": [
-    {
-      "method": "POST",
-      "path": "/acg/aspects"
-    },
     {
       "method": "POST",
       "path": "/acg/ccg"
     },
-    {
-      "method": "POST",
-      "path": "/acg/crossings"
-    },
-    {
-      "method": "GET",
-      "path": "/acg/datasets"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/declination-lines"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/features"
-    },
-    {
-      "method": "GET",
-      "path": "/acg/health"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/hermetic-lines"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/hits"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/local-space"
-    },
-    {
-      "method": "POST",
-      "path": "/acg/midpoints"
-    },
     {
       "method": "POST",
       "path": "/acg/power-lines"
     },
-    {
-      "method": "GET",
-      "path": "/calendar/astrology/cross-quarter"
-    },
-    {
-      "method": "GET",
-      "path": "/calendar/astrology/lunar-standstill"
-    },
-    {
-      "method": "GET",
-      "path": "/calendar/astrology/moon-phases"
-    },
-    {
-      "method": "GET",
-      "path": "/catalogs/bodies"
-    },
-    {
-      "method": "GET",
-      "path": "/catalogs/fixed-stars"
-    },
-    {
-      "method": "GET",
-      "path": "/catalogs/fixed-stars/groups"
-    },
     {
       "method": "POST",
-      "path": "/chinese/bazi"
-    },
-    {
-      "method": "GET",
-      "path": "/chinese/zodiac"
+      "path": "/comparative/composite/midpoint"
     },
     {
       "method": "POST",
       "path": "/comparative/composite"
     },
-    {
-      "method": "POST",
-      "path": "/comparative/composite/midpoint"
-    },
     {
       "method": "POST",
       "path": "/comparative/natal-transits"
@@ -115,26 +43,6 @@
       "method": "POST",
       "path": "/comparative/synastry"
     },
-    {
-      "method": "GET",
-      "path": "/eclipse/besselian-elements"
-    },
-    {
-      "method": "GET",
-      "path": "/eclipse/lunar/global"
-    },
-    {
-      "method": "GET",
-      "path": "/eclipse/next-visible"
-    },
-    {
-      "method": "GET",
-      "path": "/eclipse/solar/global"
-    },
-    {
-      "method": "GET",
-      "path": "/eclipse/solar/local"
-    },
     {
       "method": "GET",
       "path": "/electional/aspect-search"
@@ -143,10 +51,6 @@
       "method": "GET",
       "path": "/electional/find-window"
     },
-    {
-      "method": "GET",
-      "path": "/electional/ingress-calendar"
-    },
     {
       "method": "GET",
       "path": "/electional/moment-analysis"
@@ -155,178 +59,10 @@
       "method": "GET",
       "path": "/electional/station-tracker"
     },
-    {
-      "method": "GET",
-      "path": "/ephemeris/agro/calendar"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/agro/daily"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/agro/void-of-course"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/angles-points"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/aspect-check"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/dignities"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/fixed-stars"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/health"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/hermetic-lots"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/house-cusps"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/house-systems"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/lunar-phase"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/midpoints"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/moon/aspects"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/moon/ingresses"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/moon/phase"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/moon/void-of-course"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/natal-chart"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/natal/batch"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/planet-position"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/progressed"
-    },
     {
       "method": "POST",
       "path": "/ephemeris/relocation"
     },
-    {
-      "method": "POST",
-      "path": "/ephemeris/retrograde-status"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/schemas/natal-request"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/schemas/natal-response"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/supported-metadata"
-    },
-    {
-      "method": "GET",
-      "path": "/ephemeris/supported-objects"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points/conjunctions"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points/eight-year-star"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points/elongations"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points/phase"
-    },
-    {
-      "method": "POST",
-      "path": "/ephemeris/venus-star-points/stations"
-    },
-    {
-      "method": "GET",
-      "path": "/health"
-    },
-    {
-      "method": "POST",
-      "path": "/human-design/chart"
-    },
-    {
-      "method": "POST",
-      "path": "/human-design/composite"
-    },
-    {
-      "method": "POST",
-      "path": "/human-design/cycles/solar-return"
-    },
-    {
-      "method": "POST",
-      "path": "/human-design/penta"
-    },
-    {
-      "method": "POST",
-      "path": "/human-design/transit"
-    },
-    {
-      "method": "GET",
-      "path": "/location/autocomplete"
-    },
-    {
-      "method": "GET",
-      "path": "/location/reverse"
-    },
-    {
-      "method": "POST",
-      "path": "/predictive/events"
-    },
-    {
-      "method": "POST",
-      "path": "/predictive/returns"
-    },
     {
       "method": "POST",
       "path": "/predictive/returns/lunar"
@@ -337,63 +73,7 @@
     },
     {
       "method": "POST",
-      "path": "/predictive/transit-chart"
-    },
-    {
-      "method": "POST",
-      "path": "/predictive/transits/planet-to-degree"
-    },
-    {
-      "method": "POST",
-      "path": "/predictive/transits/search"
-    },
-    {
-      "method": "POST",
-      "path": "/predictive/transits/sign-ingresses"
-    },
-    {
-      "method": "GET",
-      "path": "/tidal/forcing"
-    },
-    {
-      "method": "GET",
-      "path": "/tidal/forcing/deep-time"
-    },
-    {
-      "method": "GET",
-      "path": "/time/delta-t"
-    },
-    {
-      "method": "GET",
-      "path": "/time/equation-of-time"
-    },
-    {
-      "method": "POST",
-      "path": "/time/julian-day"
-    },
-    {
-      "method": "POST",
-      "path": "/time/scales"
-    },
-    {
-      "method": "GET",
-      "path": "/time/sidereal"
-    },
-    {
-      "method": "GET",
-      "path": "/time/solar-event"
-    },
-    {
-      "method": "POST",
-      "path": "/timezone/lookup"
-    },
-    {
-      "method": "POST",
-      "path": "/timezone/offset"
-    },
-    {
-      "method": "POST",
-      "path": "/vedic/chart"
+      "path": "/predictive/returns"
     },
     {
       "method": "POST",
@@ -404,8 +84,8 @@
       "path": "/visualization/chart-wheel"
     }
   ],
-  "last_generated_at": "2026-03-13T19:02:57.991Z",
-  "openapi_sha256": "2462c5ba647fa831bad783d381b8782af658d15f802f98fa863bf03642d299d3",
+  "last_generated_at": "2026-03-25T15:51:37.919Z",
+  "openapi_sha256": "48a3d6db42a5957421c3c7b3a5af3f971df36a2558bce7a13943ad097dfe3621",
   "candidates_get": [
     {
       "method": "GET",
@@ -415,14 +95,6 @@
       ],
       "operationId": "datasets_acg_datasets_get"
     },
-    {
-      "method": "GET",
-      "path": "/acg/health",
-      "tags": [
-        "ACG"
-      ],
-      "operationId": "health_acg_health_get"
-    },
     {
       "method": "GET",
       "path": "/acg/meta",
@@ -543,14 +215,6 @@
       ],
       "operationId": "ElectionalFindWindowElectionalFindWindowGet"
     },
-    {
-      "method": "GET",
-      "path": "/electional/ingress-calendar",
-      "tags": [
-        "electional"
-      ],
-      "operationId": "ElectionalIngressCalendarElectionalIngressCalendarGet"
-    },
     {
       "method": "GET",
       "path": "/electional/moment-analysis",
@@ -591,14 +255,6 @@
       ],
       "operationId": "get_void_of_course_endpoint_ephemeris_agro_void_of_course_get"
     },
-    {
-      "method": "GET",
-      "path": "/ephemeris/health",
-      "tags": [
-        "health"
-      ],
-      "operationId": "health_check_ephemeris_health_get"
-    },
     {
       "method": "GET",
       "path": "/ephemeris/house-systems",
@@ -1065,6 +721,22 @@
       ],
       "operationId": "human_design_composite_human_design_composite_post"
     },
+    {
+      "method": "POST",
+      "path": "/human-design/cycles/opposition",
+      "tags": [
+        "Human Design"
+      ],
+      "operationId": "opposition_chart_human_design_cycles_opposition_post"
+    },
+    {
+      "method": "POST",
+      "path": "/human-design/cycles/return",
+      "tags": [
+        "Human Design"
+      ],
+      "operationId": "planetary_return_chart_human_design_cycles_return_post"
+    },
     {
       "method": "POST",
       "path": "/human-design/cycles/solar-return",
@@ -1089,14 +761,6 @@
       ],
       "operationId": "human_design_transit_human_design_transit_post"
     },
-    {
-      "method": "POST",
-      "path": "/predictive/events",
-      "tags": [
-        "predictive"
-      ],
-      "operationId": "calculate_predictive_events_predictive_events_post"
-    },
     {
       "method": "POST",
       "path": "/predictive/returns/lunar",
@@ -1215,49 +879,18 @@
     "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",
       "Non-GET allowlisted: POST /comparative/natal-transits",
       "Non-GET allowlisted: POST /comparative/overlay",
       "Non-GET allowlisted: POST /comparative/synastry",
-      "Non-GET allowlisted: POST /ephemeris/angles-points",
-      "Non-GET allowlisted: POST /ephemeris/aspect-check",
-      "Non-GET allowlisted: POST /ephemeris/dignities",
-      "Non-GET allowlisted: POST /ephemeris/fixed-stars",
-      "Non-GET allowlisted: POST /ephemeris/hermetic-lots",
-      "Non-GET allowlisted: POST /ephemeris/house-cusps",
-      "Non-GET allowlisted: POST /ephemeris/lunar-phase",
-      "Non-GET allowlisted: POST /ephemeris/midpoints",
-      "Non-GET allowlisted: POST /ephemeris/natal-chart",
-      "Non-GET allowlisted: POST /ephemeris/natal/batch",
-      "Non-GET allowlisted: POST /ephemeris/planet-position",
-      "Non-GET allowlisted: POST /ephemeris/progressed",
-      "Non-GET allowlisted: POST /ephemeris/retrograde-status",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points/conjunctions",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points/eight-year-star",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points/elongations",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points/phase",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points/stations",
-      "Non-GET allowlisted: POST /ephemeris/venus-star-points",
-      "Non-GET allowlisted: POST /human-design/chart",
-      "Non-GET allowlisted: POST /human-design/composite",
-      "Non-GET allowlisted: POST /human-design/cycles/solar-return",
-      "Non-GET allowlisted: POST /human-design/penta",
-      "Non-GET allowlisted: POST /human-design/transit",
-      "Non-GET allowlisted: POST /predictive/events",
+      "Non-GET allowlisted: POST /ephemeris/relocation",
       "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/transit-chart",
-      "Non-GET allowlisted: POST /predictive/transits/planet-to-degree",
-      "Non-GET allowlisted: POST /predictive/transits/search",
-      "Non-GET allowlisted: POST /predictive/transits/sign-ingresses",
-      "Non-GET allowlisted: POST /timezone/lookup",
-      "Non-GET allowlisted: POST /timezone/offset",
       "Non-GET allowlisted: POST /visualization/bi-wheel",
       "Non-GET allowlisted: POST /visualization/chart-wheel"
     ]
   }
-}
+}

package/dist/tools/dev.js

@@ -38,11 +38,14 @@ registerTool({
         "Call dev_list_allowed to see all currently available endpoint paths.\n\n" +
         "AUTH: Set OPENEPHEMERIS_API_KEY in your environment. See openephemeris.com/dashboard for active plan limits.\n\n" +
         "CREDIT COSTS:\n" +
-        "  • Standard chart math (natal, progressed, bazi, HD): 1 credit\n" +
+        "  • Standard chart math (natal, progressed, bazi, vedic, iching): 1 credit\n" +
+        "  • Human Design: 2 credits\n" +
         "  • Visualization rendering (chart-wheel, bi-wheel, charts/*): 2 credits\n" +
         "  • Comparative math (synastry, composite, overlay): 3 credits\n" +
-        "  • Predictive ops (transits, returns, transit-chart): 5 credits\n" +
-        "  • ACG / astrocartography: 5 credits\n" +
+        "  • Predictive ops (transits/search, returns): 5 credits\n" +
+        "  • Predictive transit-chart: 1 credit\n" +
+        "  • ACG / astrocartography: 10 credits (acg/hits: 15 credits)\n" +
+        "  • Calendar endpoints: 10 credits\n" +
         "  • Catalog / metadata / health endpoints: 0 credits\n" +
         "  • format=llm (token-optimized output): available on all tiers\n\n" +
         "COMMON CALLS:\n" +

package/dist/tools/index.js

@@ -39,6 +39,7 @@ export async function initTools(profile) {
         await import("./specialized/acg.js");
         await import("./specialized/comparative.js");
         await import("./specialized/hd_group.js");
+        await import("./specialized/hd_cycles.js");
         await import("./specialized/ephemeris_extended.js");
         await import("./specialized/venus_star_points.js");
     }

package/dist/tools/specialized/acg.js

@@ -11,7 +11,7 @@ registerTool({
         "Returns GeoJSON LineStrings tracing each planetary angle line around the globe. " +
         "These are the latitudinal lines where a planet was rising (AC), setting (DC), " +
         "culminating (MC), or anti-culminating (IC) at birth.\n\n" +
-        "CREDIT COST: 5 credits per call.\n\n" +
+        "CREDIT COST: 10 credits per call.\n\n" +
         "EXAMPLE: Saturn and Jupiter power lines for a chart born 1990-04-15 in Chicago:\n" +
         "  birth_datetime='1990-04-15T14:30:00', birth_latitude=41.8781, birth_longitude=-87.6298,\n" +
         "  bodies=['Saturn', 'Jupiter']",
@@ -76,7 +76,7 @@ registerTool({
     name: "acg_hits",
     description: "Find all Astrocartography lines (power lines + aspect lines) passing near a specific location. " +
         "Returns features sorted by distance, making it easy to interpret planetary influences at a place.\n\n" +
-        "CREDIT COST: 5 credits per call.\n\n" +
+        "CREDIT COST: 15 credits per call.\n\n" +
         "EXAMPLE: All ACG lines within 3° of Paris for a chart born 1990-04-15 in Chicago:\n" +
         "  birth_datetime='1990-04-15T14:30:00', birth_latitude=41.8781, birth_longitude=-87.6298,\n" +
         "  query_latitude=48.8566, query_longitude=2.3522, radius_deg=3",

package/dist/tools/specialized/electional.js

@@ -166,54 +166,6 @@ registerTool({
         });
     },
 });
-// GET /electional/ingress-calendar
-registerTool({
-    name: "electional_ingress_calendar",
-    description: "Get a calendar of sign ingresses — when planets change zodiac signs. " +
-        "Returns each ingress event with exact time, from/to signs, and retrograde flag.\n\n" +
-        "CREDIT COST: 3 credits per call.\n\n" +
-        "EXAMPLE: Ingresses in March 2026:\n" +
-        "  start_date='2026-03-01', end_date='2026-03-31'",
-    inputSchema: {
-        type: "object",
-        properties: {
-            start_date: {
-                type: "string",
-                description: "Start date (ISO 8601). Defaults to now.",
-            },
-            end_date: {
-                type: "string",
-                description: "End date (ISO 8601). Defaults to +30 days.",
-            },
-            planets: {
-                type: "string",
-                description: "Comma-separated planet IDs. Defaults to all major planets.",
-            },
-            format: {
-                type: "string",
-                enum: ["json", "llm"],
-                description: "Output format.",
-            },
-        },
-        required: [],
-        additionalProperties: false,
-    },
-    handler: async (args) => {
-        const query = {};
-        if (args.start_date)
-            query.start_date = args.start_date;
-        if (args.end_date)
-            query.end_date = args.end_date;
-        if (args.planets)
-            query.planets = args.planets;
-        if (args.format)
-            query.format = args.format;
-        return await backendClient.request("GET", "/electional/ingress-calendar", {
-            data: {},
-            params: query,
-        });
-    },
-});
 // GET /electional/aspect-search
 registerTool({
     name: "electional_aspect_search",

package/dist/tools/specialized/hd_cycles.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/specialized/hd_cycles.js

@@ -0,0 +1,115 @@
+import { registerTool, validateRequired } from "../index.js";
+import { backendClient } from "../../backend/client.js";
+/**
+ * Ensure a datetime string has a timezone offset for Go's time.Time parsing.
+ */
+function ensureTimezone(dt) {
+    if (!dt)
+        return dt;
+    if (/[Zz]$/.test(dt) || /[+-]\d{2}:\d{2}$/.test(dt) || /[+-]\d{4}$/.test(dt))
+        return dt;
+    return dt + "Z";
+}
+registerTool({
+    name: "hd_planetary_return",
+    description: "Calculate a Human Design planetary return chart — full HD chart " +
+        "(type, strategy, authority, gates, channels) at the moment a planet " +
+        "returns to its natal position. Supports all HD-relevant planets.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "Key returns in Human Design:\n" +
+        "  • Saturn Return (~29y, ~59y) — maturation/authority activation\n" +
+        "  • Chiron Return (~50y) — wound-to-teaching integration\n" +
+        "  • Jupiter Return (~12y) — expansion cycles\n" +
+        "  • Mars Return (~2y) — energy/drive reset\n" +
+        "  • Lunar Return (~27.3d) — emotional/body cycle\n\n" +
+        "EXAMPLE: Saturn return chart for birth 1990-04-15:\n" +
+        "  planet='saturn', datetime='1990-04-15T19:30:00Z', return_year=2020",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet: {
+                type: "string",
+                enum: ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto", "chiron", "pholus"],
+                description: "Planet to calculate the return for.",
+            },
+            datetime: {
+                type: "string",
+                description: "ISO 8601 birth datetime in UTC, e.g. '1990-04-15T19:30:00Z'.",
+            },
+            return_year: {
+                type: "integer",
+                description: "Year to find the return near (e.g. 2020 for a Saturn return at ~age 29).",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "llm"],
+                description: "Output format. 'llm' returns compact projection for token efficiency.",
+            },
+        },
+        required: ["planet", "datetime", "return_year"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["planet", "datetime", "return_year"]);
+        return await backendClient.request("POST", "/human-design/cycles/return", {
+            data: {
+                planet: args.planet,
+                birth_datetime_utc: ensureTimezone(args.datetime),
+                return_year: args.return_year,
+                format: args.format,
+                include_chiron: args.include_chiron,
+                include_lilith: args.include_lilith,
+            },
+        });
+    },
+});
+registerTool({
+    name: "hd_opposition",
+    description: "Calculate a Human Design opposition chart — the HD chart " +
+        "at the moment a planet opposes its natal position (180°).\n\n" +
+        "Key oppositions in Human Design:\n" +
+        "  • Uranus Opposition (~age 42) — midlife awakening/individuation\n" +
+        "  • Saturn Opposition (~age 14-15, ~44) — structural tension\n" +
+        "  • Jupiter Opposition (~age 6, ~18, ~30) — expansion challenges\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "EXAMPLE: Uranus opposition for birth 1983-07-15:\n" +
+        "  planet='uranus', datetime='1983-07-15T12:00:00Z', target_year=2025",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet: {
+                type: "string",
+                enum: ["uranus", "saturn", "jupiter"],
+                description: "Planet to calculate the opposition for.",
+            },
+            datetime: {
+                type: "string",
+                description: "ISO 8601 birth datetime in UTC, e.g. '1983-07-15T12:00:00Z'.",
+            },
+            target_year: {
+                type: "integer",
+                description: "Year to search for the opposition near.",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "llm"],
+                description: "Output format. 'llm' returns compact projection for token efficiency.",
+            },
+        },
+        required: ["planet", "datetime", "target_year"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["planet", "datetime", "target_year"]);
+        return await backendClient.request("POST", "/human-design/cycles/opposition", {
+            data: {
+                planet: args.planet,
+                birth_datetime_utc: ensureTimezone(args.datetime),
+                target_year: args.target_year,
+                format: args.format,
+                include_chiron: args.include_chiron,
+                include_lilith: args.include_lilith,
+            },
+        });
+    },
+});

package/dist/tools/specialized/human_design.js

@@ -18,7 +18,7 @@ registerTool({
         "(Generator, Manifesting Generator, Projector, Manifestor, Reflector), Strategy, Authority, " +
         "Profile (e.g. 1/3, 2/4), defined and undefined Centers, activated Gates and Channels, " +
         "Incarnation Cross, and both Personality (conscious) and Design (unconscious) planetary positions.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
         "Human Design uses two calculation moments: the birth time (Personality) and ~88° of Sun motion " +
         "before birth (~3 months prior, the Design calculation). The API handles this automatically.\n\n" +
         "IMPORTANT: The datetime should be in UTC. If you have local birth time, convert to UTC first.\n\n" +

package/dist/tools/specialized/progressed.js

@@ -5,7 +5,7 @@ registerTool({
     description: "Calculate a Secondary Progressed (or Solar Arc / Tertiary) chart. " +
         "Advances the natal chart symbolically — 1 day = 1 year (secondary), or using solar arc motion. " +
         "Returns progressed planet positions, house cusps, aspects, and retrograde status.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
         "EXAMPLE: Secondary progressions for someone born 1985-06-21, progressed to 2026-01-01:\n" +
         "  birth_datetime='1985-06-21T14:00:00', birth_latitude=51.5, birth_longitude=-0.12,\n" +
         "  target_datetime='2026-01-01', method='secondary'",

package/dist/tools/specialized/returns.js

@@ -5,7 +5,7 @@ registerTool({
     name: "ephemeris_solar_return",
     description: "Calculate the exact Solar Return date/time — when the Sun returns to its natal ecliptic longitude. " +
         "Used to cast the Solar Return chart for the year ahead.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
+        "CREDIT COST: 5 credits per call.\n\n" +
         "EXAMPLE: Solar return for someone born 1985-06-21 near their 2026 birthday:\n" +
         "  birth_datetime='1985-06-21T14:00:00', target_datetime='2026-06-01'",
     inputSchema: {
@@ -65,7 +65,7 @@ registerTool({
     name: "ephemeris_lunar_return",
     description: "Calculate the exact Lunar Return date/time — when the Moon returns to its natal ecliptic longitude (~every 27.3 days). " +
         "Used to cast the monthly Lunar Return chart.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
+        "CREDIT COST: 5 credits per call.\n\n" +
         "EXAMPLE: Next lunar return after 2026-03-15 for someone born 1990-04-15:\n" +
         "  birth_datetime='1990-04-15T14:30:00', target_datetime='2026-03-15'",
     inputSchema: {
@@ -112,7 +112,7 @@ registerTool({
     description: "Calculate a planetary return — when any planet returns to its natal longitude. " +
         "Useful for Jupiter returns (~12 years), Saturn returns (~29 years), Chiron returns (~50 years), " +
         "Uranus returns (~84 years), etc.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
+        "CREDIT COST: 5 credits per call.\n\n" +
         "EXAMPLE: Saturn return for birth 1990-04-15 near year 2019:\n" +
         "  body='saturn', birth_datetime='1990-04-15T14:30:00', target_datetime='2019-01-01'\n" +
         "EXAMPLE: Chiron return for birth 1975-03-10 near age 50:\n" +

package/package.json

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