@openephemeris/mcp-server 3.2.8 → 3.2.9

package/dist/src/tools/specialized/transits.js

@@ -6,7 +6,9 @@ registerTool({
         "Returns a list of exact transit moments — when transiting planets form specified aspects " +
         "to natal planet positions. Ideal for generating horoscope timelines, event forecasting, or " +
         "finding optimal timing windows.\n\n" +
-        "CREDIT COST: 5 credits per call.\n\n" +
+        "HOW IT WORKS: This tool first calculates the natal chart to extract your actual planetary " +
+        "ecliptic longitudes, then searches for transiting planets crossing those exact degrees.\n\n" +
+        "CREDIT COST: 6 credits per call (1 for natal + 5 for transit search).\n\n" +
         "EXAMPLE: Find all Saturn transits to the natal Sun/Moon for the next 6 months:\n" +
         "  natal_datetime='1990-04-15T14:30:00', natal_latitude=41.8781, natal_longitude=-87.6298,\n" +
         "  start_date='2026-01-01', end_date='2026-06-30', transiting_planets=['saturn']",
@@ -42,16 +44,7 @@ registerTool({
             natal_points: {
                 type: "array",
                 items: { type: "string" },
-                description: "Natal point IDs to receive transits. E.g. ['sun', 'moon', 'asc', 'mc']. Omit for all core points.",
-            },
-            aspects: {
-                type: "array",
-                items: { type: "string", enum: ["conjunction", "opposition", "trine", "square", "sextile"] },
-                description: "Aspect types to include in the search. Defaults to all major aspects.",
-            },
-            orb: {
-                type: "number",
-                description: "Maximum orb in degrees (default: 1.0).",
+                description: "Natal point IDs whose exact longitudes should be targeted. E.g. ['sun', 'moon', 'asc', 'mc']. Omit for all core points.",
             },
         },
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
@@ -59,6 +52,58 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
+        // ── Step 1: Compute natal chart to extract real planetary longitudes ──
+        const natalBody = {
+            subject: {
+                name: "Transit Natal Subject",
+                birth_datetime: { iso: args.natal_datetime },
+                birth_location: {
+                    latitude: { decimal: args.natal_latitude },
+                    longitude: { decimal: args.natal_longitude }
+                },
+            },
+        };
+        const natalResult = await backendClient.post("/ephemeris/natal", natalBody);
+        // Extract ecliptic longitudes from natal chart planets
+        const targetDegrees = [];
+        const natalPositionMap = {};
+        // The natal response typically has a `planets` array or object
+        const planets = natalResult?.planets || natalResult?.data?.planets || [];
+        const planetArray = Array.isArray(planets) ? planets : Object.values(planets);
+        // Filter to requested natal points if specified
+        const wantedPoints = args.natal_points
+            ? new Set(args.natal_points.map((p) => p.toLowerCase()))
+            : null;
+        for (const planet of planetArray) {
+            const name = (planet.name || planet.id || "").toLowerCase();
+            const lon = planet.longitude ?? planet.ecliptic_longitude ?? planet.lon;
+            if (typeof lon !== "number" || !isFinite(lon))
+                continue;
+            if (wantedPoints && !wantedPoints.has(name))
+                continue;
+            targetDegrees.push(Math.round(lon * 100) / 100); // 2 decimal places
+            natalPositionMap[name] = lon;
+        }
+        // Also extract angles (ASC, MC, DSC, IC) if present
+        const angles = natalResult?.angles || natalResult?.data?.angles;
+        if (angles) {
+            const angleEntries = Array.isArray(angles) ? angles : Object.entries(angles).map(([k, v]) => ({ name: k, ...(typeof v === 'object' ? v : { longitude: v }) }));
+            for (const angle of angleEntries) {
+                const name = (angle.name || angle.id || "").toLowerCase();
+                const lon = angle.longitude ?? angle.ecliptic_longitude ?? angle.lon;
+                if (typeof lon !== "number" || !isFinite(lon))
+                    continue;
+                if (wantedPoints && !wantedPoints.has(name))
+                    continue;
+                targetDegrees.push(Math.round(lon * 100) / 100);
+                natalPositionMap[name] = lon;
+            }
+        }
+        if (targetDegrees.length === 0) {
+            throw new Error("Could not extract natal planet longitudes from the natal chart calculation. " +
+                "Please verify your natal_datetime, natal_latitude, and natal_longitude are correct.");
+        }
+        // ── Step 2: Search transits against those real natal longitudes ──
         let startStr = args.start_date;
         if (/^\d{4}-\d{2}-\d{2}$/.test(startStr)) {
             startStr += "T00:00:00Z";
@@ -67,26 +112,19 @@ registerTool({
         if (/^\d{4}-\d{2}-\d{2}$/.test(endStr)) {
             endStr += "T23:59:59Z";
         }
-        const body = {
+        const transitBody = {
             start_date: startStr,
             end_date: endStr,
-            natal_chart: {
-                datetime: args.natal_datetime,
-                latitude: args.natal_latitude,
-                longitude: args.natal_longitude,
-            },
+            target_degrees: targetDegrees,
         };
         if (args.transiting_planets)
-            body.planet_names = args.transiting_planets;
-        const searchCriteria = {};
-        if (args.natal_points)
-            searchCriteria.natal_points = args.natal_points;
-        if (args.aspects)
-            searchCriteria.aspects = args.aspects;
-        if (args.orb != null)
-            searchCriteria.orb = args.orb;
-        if (Object.keys(searchCriteria).length > 0)
-            body.search_criteria = searchCriteria;
-        return await backendClient.request("POST", "/predictive/transits/search", { data: body });
+            transitBody.planet_names = args.transiting_planets;
+        const transitResult = await backendClient.request("POST", "/predictive/transits/search", { data: transitBody });
+        // Return combined context so the LLM knows what natal positions were targeted
+        return {
+            natal_positions: natalPositionMap,
+            target_degrees_used: targetDegrees,
+            transit_results: transitResult,
+        };
     },
 });

package/package.json

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