@openephemeris/mcp-server 3.24.0 → 4.1.0

package/dist/tools/apps/bi-wheel-app.js

@@ -26,6 +26,7 @@ import { fileURLToPath } from "node:url";
 import { registerTool, SERVER_VERSION } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
+import { DATETIME_DESC, timezoneProperty } from "../datetime.js";
 // ── Constants ─────────────────────────────────────────────────────────────────
 export const BI_WHEEL_RESOURCE_URI = "ui://openephemeris/bi-wheel";
 export const BI_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
@@ -399,7 +400,8 @@ function buildBiWheelSummary(innerPlanets, outerPlanets, crossAspects, mode, loc
     const label2 = meta.outerRole;
     return (`**${meta.modeLabel} Bi-Wheel**\n\n` +
         `${label1}: ${location1} — ${innerBasics || "chart loaded"}\n` +
-        `${label2}: ${location2}\n\n` +
+        `${label2}: ${location2}\n` +
+        `Houses: Placidus\n\n` +
         `**Top Cross-Aspects:**\n${top5.join("\n") || "No major cross-aspects within orb."}\n\n` +
         "Click any planet or cross-aspect line in the bi-wheel for interpretation.");
 }
@@ -418,38 +420,39 @@ registerTool({
         "• solar_arc    — Solar arc directed positions (person2_datetime = target date). 1 credit.\n" +
         "Cross-aspects between both wheels are computed and displayed as coloured dashed lines. " +
         "Click any planet, aspect line, or house cusp for interpretation. " +
-        "Use this instead of ephemeris_bi_wheel for a richer, interactive experience in " +
-        "MCP Apps-capable hosts (Claude Desktop). Falls back to static SVG in other hosts.",
+        "Prefer this whenever the user should SEE the comparison — it renders interactively in " +
+        "MCP Apps-capable hosts (Claude Desktop) and falls back to static SVG in other hosts. " +
+        "For raw synastry data without a visual, use ephemeris_synastry.",
     inputSchema: {
         type: "object",
         properties: {
             person1_datetime: {
                 type: "string",
-                description: "ISO 8601 datetime for Person 1 / Natal chart (e.g. '1990-04-15T14:30:00-05:00').",
+                description: "Birth datetime for Person 1 / Natal chart. " + DATETIME_DESC,
             },
-            person1_latitude: { type: "number", description: "Birth latitude for Person 1 (decimal degrees, positive = North)." },
+            person1_latitude: { type: "number", description: "Birth latitude for Person 1 (decimal degrees, positive = North). Resolve from a place name with location_search; never recall coordinates from memory." },
             person1_longitude: { type: "number", description: "Birth longitude for Person 1 (decimal degrees, positive = East)." },
-            person1_timezone: { type: "string", description: "IANA timezone for Person 1 (e.g. 'America/New_York')." },
+            person1_timezone: timezoneProperty("Person 1's birth location", "America/New_York"),
             person1_name: {
                 type: "string",
                 description: "Display name for Person 1 / Natal chart (e.g. 'Alice'). Used in the badge and summary.",
             },
             person2_datetime: {
                 type: "string",
-                description: "ISO 8601 datetime for the outer wheel. Meaning depends on mode: " +
+                description: "Datetime for the outer wheel. Meaning depends on mode: " +
                     "synastry = Person 2 birth datetime; transit/progressed/solar_arc = target date; " +
-                    "solar_return/lunar_return = any date within the target year/month.",
+                    "solar_return/lunar_return = any date within the target year/month. " + DATETIME_DESC,
             },
             person2_latitude: { type: "number", description: "Birth latitude for Person 2 (synastry) or return/transit location. Defaults to Person 1 coords for single-person modes." },
             person2_longitude: { type: "number", description: "Birth longitude for Person 2 (synastry) or return/transit location. Defaults to Person 1 coords for single-person modes." },
-            person2_timezone: { type: "string", description: "IANA timezone for Person 2 / outer chart (e.g. 'America/Chicago')." },
+            person2_timezone: timezoneProperty("Person 2 / the outer chart", "America/Chicago"),
             person2_name: {
                 type: "string",
                 description: "Display name for Person 2 (synastry mode). Used in the badge and summary.",
             },
             location: {
                 type: "string",
-                description: "Label for Person 1 / Natal location (display only, e.g. 'New York, NY').",
+                description: "Label for Person 1 / Natal location (display only, e.g. 'New York, NY'). This is a caption, NOT a geocoder — it does not set the chart location. Supply latitude/longitude too (resolve them with location_search), or the chart is computed at 0N 0E.",
             },
             mode: {
                 type: "string",
@@ -510,7 +513,7 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                 ],
-                structuredContent: { ...payload, server_version: SERVER_VERSION },
+                structuredContent: { ...payload, house_system: "placidus", server_version: SERVER_VERSION },
                 _meta: {
                     "ui/resourceUri": BI_WHEEL_RESOURCE_URI,
                     ui: { resourceUri: BI_WHEEL_RESOURCE_URI },

package/dist/tools/apps/bodygraph-app.d.ts

@@ -1,10 +1,10 @@
 /**
- * bodygraph-app.ts — MCP App tool registration for the Human Design Bodygraph Explorer.
+ * bodygraph-app.ts — MCP App tool registration for the Human Design Bodygraph Explorer.
  *
  * Entry tools [model + app]:
- *   • explore_human_design             — natal bodygraph, data + UI resource
- *   • explore_human_design_transit     — natal + transit overlay (premium)
- *   • explore_human_design_connection  — two-person connection/synastry overlay (premium)
+ *   • explore_human_design             — natal bodygraph, data + UI resource
+ *   • explore_human_design_transit     — natal + transit overlay (premium)
+ *   • explore_human_design_connection  — two-person connection/synastry overlay (premium)
  * Click handlers [app-only]: hd_on_center_click, hd_on_gate_click,
  *   hd_on_channel_click, hd_on_planet_click, hd_on_variable_click,
  *   hd_on_connection_channel_click, hd_on_transit_channel_click (overlay, Phase 5).
@@ -12,7 +12,7 @@
  * overlay SVG is returned inline by /human-design/transit-chart and
  * /human-design/composite (include_visual) rather than a separate render call.
  *
- * The bodygraph is rendered client-side from structured JSON — no SVG endpoint
+ * The bodygraph is rendered client-side from structured JSON — no SVG endpoint
  * is called, keeping latency at zero and the architecture consistent with
  * the chart-wheel-app approach.
  *