@openephemeris/mcp-server 3.3.3 → 3.4.0

package/dist/tools/specialized/returns.js

@@ -110,16 +110,19 @@ registerTool({
 registerTool({
     name: "ephemeris_planetary_return",
     description: "Calculate a planetary return — when any planet returns to its natal longitude. " +
-        "Useful for Jupiter returns (~12 years), Saturn returns (~29 years), etc.\n\n" +
+        "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" +
         "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'",
+        "  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" +
+        "  body='chiron', birth_datetime='1975-03-10T08:00:00', target_datetime='2025-01-01'",
     inputSchema: {
         type: "object",
         properties: {
             body: {
                 type: "string",
-                description: "Planet name: sun, moon, mercury, venus, mars, jupiter, saturn.",
+                description: "Planet name: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron, pholus.",
             },
             birth_datetime: {
                 type: "string",

package/dist/tools/specialized/transits.js

@@ -8,6 +8,13 @@ registerTool({
         "finding optimal timing windows.\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" +
+        "ASPECT ANGLES: Use aspect_angle to search for specific aspects to natal positions:\n" +
+        "  0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine.\n" +
+        "  Example: Saturn Return → transiting_planets=['saturn'], natal_points=['saturn'], aspect_angle=0\n" +
+        "  Example: Uranus Opposition → transiting_planets=['uranus'], natal_points=['uranus'], aspect_angle=180\n" +
+        "  Example: Chiron Return → transiting_planets=['chiron'], natal_points=['chiron'], aspect_angle=0\n\n" +
+        "SUPPORTED BODIES: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, " +
+        "Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode.\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" +
@@ -38,13 +45,19 @@ registerTool({
             transiting_planets: {
                 type: "array",
                 items: { type: "string" },
-                description: "List of transiting planet IDs to search. E.g. ['saturn', 'jupiter', 'uranus', 'pluto']. " +
+                description: "List of transiting planet IDs to search. E.g. ['saturn', 'jupiter', 'uranus', 'pluto', 'chiron']. " +
                     "Omit to search all outer planets.",
             },
             natal_points: {
                 type: "array",
                 items: { type: "string" },
-                description: "Natal point IDs whose exact longitudes should be targeted. E.g. ['sun', 'moon', 'asc', 'mc']. Omit for all core points.",
+                description: "Natal point IDs whose exact longitudes should be targeted. E.g. ['sun', 'moon', 'asc', 'mc', 'saturn', 'chiron']. Omit for all core points.",
+            },
+            aspect_angle: {
+                type: "number",
+                description: "Aspect angle in degrees to apply to each natal longitude. 0 = conjunction/return (default), " +
+                    "180 = opposition, 90 = square, 120 = trine. The effective search target becomes " +
+                    "(natal_longitude + aspect_angle) mod 360.",
             },
         },
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
@@ -119,11 +132,21 @@ registerTool({
         };
         if (args.transiting_planets)
             transitBody.planet_names = args.transiting_planets;
+        // When aspect_angle is provided, apply offset to compute effective target degrees
+        // (natal_lon + aspect_angle) mod 360 for each natal point
+        let effectiveTargets = targetDegrees;
+        if (typeof args.aspect_angle === "number" && args.aspect_angle !== 0) {
+            effectiveTargets = targetDegrees.map((deg) => ((deg + args.aspect_angle) % 360 + 360) % 360);
+            transitBody.target_degrees = effectiveTargets;
+            // Also include aspect metadata for labeling in results
+            transitBody.search_criteria = { aspect_angle: args.aspect_angle };
+        }
         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,
+            target_degrees_used: effectiveTargets,
+            aspect_angle: args.aspect_angle ?? 0,
             transit_results: transitResult,
         };
     },

package/package.json

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