@openephemeris/mcp-server 3.24.0 → 4.0.0

package/dist/tools/specialized/venus_star_points.js

@@ -1,13 +1,16 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
-function buildSubject(datetime, lat, lon) {
+import { DATETIME_DESC, TIMEZONE_PROPERTY, assertZonedDatetime } from "../datetime.js";
+function buildSubject(datetime, lat, lon, timezone) {
     return {
         name: "Subject",
         birth_datetime: { iso: datetime },
         birth_location: {
             latitude: { decimal: lat },
             longitude: { decimal: lon },
+            // The server resolves the IANA zone, so historical DST stays correct.
+            ...(timezone ? { timezone: { iana_name: timezone } } : {}),
         },
     };
 }
@@ -16,13 +19,14 @@ registerTool({
     name: "venus_star_points",
     description: "Get Venus Star Points — the Sun-Venus conjunction events nearest to a birth date. " +
         "Shows the quality of each conjunction (cazimi, combust, under beams) with zodiac details.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
         "EXAMPLE: Venus star points for someone born 1990-04-15:\n" +
-        "  datetime='1990-04-15T14:30:00', latitude=41.88, longitude=-87.63",
+        "  datetime='1990-04-15T14:30:00', timezone='America/Chicago', latitude=41.88, longitude=-87.63",
     inputSchema: {
         type: "object",
         properties: {
-            datetime: { type: "string", description: "Birth datetime (ISO 8601)." },
+            datetime: { type: "string", description: DATETIME_DESC },
+            timezone: TIMEZONE_PROPERTY,
             latitude: { type: "number", description: "Birth latitude." },
             longitude: { type: "number", description: "Birth longitude." },
             format: { type: "string", enum: ["json", "llm"], description: "Output format." },
@@ -34,11 +38,12 @@ registerTool({
     annotations: { title: "Venus Star Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
+        assertZonedDatetime("datetime", args.datetime, args.timezone);
         const query = {};
         if (args.format)
             query.format = args.format;
         return await getActiveClient().request("POST", "/ephemeris/venus-star-points", {
-            data: { subject: buildSubject(args.datetime, args.latitude, args.longitude) },
+            data: { subject: buildSubject(args.datetime, args.latitude, args.longitude, args.timezone) },
             params: query,
         });
     },
@@ -48,7 +53,7 @@ registerTool({
     name: "venus_star_points_conjunctions",
     description: "Find all Sun-Venus conjunctions in a date range. Returns each conjunction with " +
         "its exact timestamp, zodiac position, orb, visibility (morning/evening star), and dignity.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
         "EXAMPLE: Find Venus conjunctions in 2026:\n" +
         "  start_date='2026-01-01', end_date='2026-12-31'",
     inputSchema: {
@@ -80,7 +85,7 @@ registerTool({
     description: "Compute the 8-year Venus Star pattern — the pentagram of 5 Venus-Sun conjunctions " +
         "that trace a near-perfect star over 8 years (the Venus synodic cycle). Returns the 5 " +
         "vertices with their zodiac positions.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
         "EXAMPLE: 8-year star starting from 2020:\n" +
         "  date='2020-01-01'",
     inputSchema: {
@@ -141,7 +146,7 @@ registerTool({
     name: "venus_elongations",
     description: "Find Venus greatest elongation events (when Venus is farthest from the Sun in the sky). " +
         "Returns east (evening star) and west (morning star) elongation peaks.\n\n" +
-        "CREDIT COST: 2 credits per call.",
+        "CREDIT COST: 1 credit per call.",
     inputSchema: {
         type: "object",
         properties: {
@@ -170,7 +175,7 @@ registerTool({
     name: "venus_stations",
     description: "Find Venus retrograde and direct stations in a date range. Returns the exact " +
         "moment Venus appears to stop and reverse direction.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
         "EXAMPLE: Venus stations in 2026:\n" +
         "  start_date='2026-01-01', end_date='2026-12-31'",
     inputSchema: {