@openephemeris/mcp-server 3.10.0 → 3.10.2

package/README.md

@@ -355,8 +355,8 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 
 - Allowlisted operations: **23**
 - Methods: `GET=4`, `POST=19`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **52**
-- 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_next_lunar_phase`, `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_bodygraph`, `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`
+- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **57**
+- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `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_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_natal_chart`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `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

package/config/dev-allowlist.json

@@ -391,14 +391,6 @@
       ],
       "operationId": "reverse_geocode_location_reverse_get"
     },
-    {
-      "method": "GET",
-      "path": "/tidal/forcing/deep-time",
-      "tags": [
-        "tidal"
-      ],
-      "operationId": "get_tidal_forcing_deep_time_endpoint_tidal_forcing_deep_time_get"
-    },
     {
       "method": "GET",
       "path": "/tidal/forcing",

package/dist/index.js

@@ -4,8 +4,9 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
+import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
 function resolveServerVersion() {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -34,6 +35,7 @@ const server = new Server({
     capabilities: {
         tools: {},
         prompts: {},
+        resources: {},
     },
 });
 // List available tools
@@ -92,6 +94,41 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
         ]
     };
 });
+// List available resources
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const bundle = getChartWheelBundle();
+    if (!bundle)
+        return { resources: [] };
+    return {
+        resources: [
+            {
+                uri: CHART_WHEEL_RESOURCE_URI,
+                name: "Chart Wheel Explorer",
+                description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+                mimeType: CHART_WHEEL_MIME_TYPE,
+            },
+        ],
+    };
+});
+// Read resource
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
+        throw new Error(`Unknown resource: ${request.params.uri}`);
+    }
+    const bundle = getChartWheelBundle();
+    if (!bundle) {
+        throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+    }
+    return {
+        contents: [
+            {
+                uri: CHART_WHEEL_RESOURCE_URI,
+                mimeType: CHART_WHEEL_MIME_TYPE,
+                text: bundle,
+            },
+        ],
+    };
+});
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const toolName = request.params.name;

package/dist/server-sse.js

@@ -21,9 +21,10 @@ import axios from "axios";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
 import { BackendClient, runWithClient } from "./backend/client.js";
+import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -184,7 +185,7 @@ function createMcpServer() {
                 "and more — powered by JPL DE440 ephemerides for sub-arcsecond accuracy.",
         },
     }, {
-        capabilities: { tools: {}, prompts: {} },
+        capabilities: { tools: {}, prompts: {}, resources: {} },
         instructions: "Open Ephemeris is a precision astronomical computation engine. " +
             "Use format='llm' on any tool for compact, token-efficient output. " +
             "All computations use JPL DE440 ephemerides for sub-arcsecond accuracy. " +
@@ -240,6 +241,40 @@ function createMcpServer() {
             };
         }
     });
+    // --- Resource handlers ---
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const bundle = getChartWheelBundle();
+        if (!bundle)
+            return { resources: [] };
+        return {
+            resources: [
+                {
+                    uri: CHART_WHEEL_RESOURCE_URI,
+                    name: "Chart Wheel Explorer",
+                    description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+                    mimeType: CHART_WHEEL_MIME_TYPE,
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
+            throw new Error(`Unknown resource: ${request.params.uri}`);
+        }
+        const bundle = getChartWheelBundle();
+        if (!bundle) {
+            throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        }
+        return {
+            contents: [
+                {
+                    uri: CHART_WHEEL_RESOURCE_URI,
+                    mimeType: CHART_WHEEL_MIME_TYPE,
+                    text: bundle,
+                },
+            ],
+        };
+    });
     return server;
 }
 const httpSessions = new Map();

package/dist/tools/apps/chart-wheel-app.d.ts

@@ -0,0 +1,19 @@
+/**
+ * chart-wheel-app.ts — MCP App tool registration for the Chart Wheel Explorer.
+ *
+ * Registers 5 tools:
+ *   • explore_natal_chart         — primary entry point, returns data + UI resource
+ *   • chart_wheel_on_planet_click — event handler for planet clicks
+ *   • chart_wheel_on_house_click  — event handler for house clicks
+ *   • chart_wheel_on_aspect_click — event handler for aspect clicks
+ *   • chart_wheel_recalculate     — recalculates with a different house system
+ *
+ * Also exports resource helpers (getChartWheelBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+export declare const CHART_WHEEL_RESOURCE_URI = "ui://openephemeris/chart-wheel";
+export declare const CHART_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getChartWheelBundle(): string | null;
+/** Reset cache (useful in dev watch mode or tests). */
+export declare function clearBundleCache(): void;

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

@@ -0,0 +1,478 @@
+/**
+ * chart-wheel-app.ts — MCP App tool registration for the Chart Wheel Explorer.
+ *
+ * Registers 5 tools:
+ *   • explore_natal_chart         — primary entry point, returns data + UI resource
+ *   • chart_wheel_on_planet_click — event handler for planet clicks
+ *   • chart_wheel_on_house_click  — event handler for house clicks
+ *   • chart_wheel_on_aspect_click — event handler for aspect clicks
+ *   • chart_wheel_recalculate     — recalculates with a different house system
+ *
+ * Also exports resource helpers (getChartWheelBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { registerTool } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+// ── Constants ─────────────────────────────────────────────────────────────
+export const CHART_WHEEL_RESOURCE_URI = "ui://openephemeris/chart-wheel";
+export const CHART_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+// Bundle path: at runtime (compiled), __dirname = dist/tools/apps/
+//   so ../../../dist/ui/ = dist/ui/  ✓
+// In dev (tsx),            __dirname = src/tools/apps/
+//   so ../../../dist/ui/ = dist/ui/  ✓ (UI pre-build always goes to dist/ui/)
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATHS = [
+    // Works in both compiled (dist/tools/apps) and dev (src/tools/apps)
+    path.resolve(here, "..", "..", "..", "dist", "ui", "chart-wheel.html"),
+];
+function findBundlePath() {
+    for (const p of BUNDLE_PATHS) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+let cachedBundle = null;
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export function getChartWheelBundle() {
+    if (cachedBundle)
+        return cachedBundle;
+    const bundlePath = findBundlePath();
+    if (!bundlePath)
+        return null;
+    try {
+        cachedBundle = fs.readFileSync(bundlePath, "utf-8");
+        return cachedBundle;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reset cache (useful in dev watch mode or tests). */
+export function clearBundleCache() {
+    cachedBundle = null;
+}
+// ── House system helpers ───────────────────────────────────────────────────
+const HOUSE_SYSTEM_MAP = {
+    placidus: "P", whole_sign: "W", equal: "E", koch: "K",
+    campanus: "C", regiomontanus: "R",
+};
+/** Build the nested request body expected by /ephemeris/natal-chart (POST). */
+function buildNatalBody(datetime, lat, lon, houseSystem, timezone) {
+    const body = {
+        subject: {
+            name: "MCP Request",
+            birth_datetime: { iso: datetime },
+            birth_location: {
+                latitude: { decimal: lat ?? 0 },
+                longitude: { decimal: lon ?? 0 },
+            },
+        },
+        configuration: {
+            house_system: HOUSE_SYSTEM_MAP[houseSystem] ?? "P",
+        },
+    };
+    if (timezone) {
+        body.subject.birth_location.timezone = { iana_name: timezone };
+    }
+    return body;
+}
+// ── Tool: explore_natal_chart ──────────────────────────────────────────────
+registerTool({
+    name: "explore_natal_chart",
+    description: "Generate an interactive natal chart wheel with clickable planets, houses, and aspects. " +
+        "Returns an embedded visual chart explorer that lets you click any planet, house, or aspect " +
+        "line for instant astrological interpretation. " +
+        "Supports house system switching (Placidus, Whole Sign, Equal, Koch). " +
+        "The chart is computed using NASA JPL DE440 ephemerides for sub-arcsecond precision. " +
+        "Use this instead of ephemeris_chart_wheel for a richer, interactive experience in " +
+        "MCP Apps-capable hosts (Claude Desktop). Falls back to static SVG in other hosts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: {
+                type: "string",
+                description: "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00'. " +
+                    "Include timezone offset if known, e.g. '1990-04-15T14:30:00-05:00'.",
+            },
+            timezone: {
+                type: "string",
+                description: "IANA timezone name (e.g. 'America/New_York'). Used if datetime has no UTC offset.",
+            },
+            latitude: {
+                type: "number",
+                description: "Birth latitude in decimal degrees (positive = North).",
+            },
+            longitude: {
+                type: "number",
+                description: "Birth longitude in decimal degrees (positive = East).",
+            },
+            location: {
+                type: "string",
+                description: "Location name for display only (e.g. 'New York, NY').",
+            },
+            house_system: {
+                type: "string",
+                enum: ["placidus", "whole_sign", "equal", "koch", "regiomontanus", "campanus"],
+                description: "House system to use (default: placidus).",
+            },
+        },
+        required: ["datetime", "latitude", "longitude"],
+    },
+    annotations: {
+        title: "Interactive Chart Wheel Explorer",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (args) => {
+        const client = getActiveClient();
+        const houseSystem = args.house_system ?? "placidus";
+        const datetime = String(args.datetime);
+        const lat = args.latitude;
+        const lon = args.longitude;
+        const natalBody = buildNatalBody(datetime, lat, lon, houseSystem, args.timezone);
+        // Parallel: fetch JSON data + SVG visual
+        const [chartData, svgBinary] = await Promise.all([
+            client.post("/ephemeris/natal-chart", natalBody),
+            client.post(`/visualization/chart-wheel?format=svg&size=800`, { ...natalBody, style: "light" }).catch(() => null),
+        ]);
+        // Decode SVG from binary response (base64 → UTF-8 string)
+        let svgString = null;
+        if (svgBinary && typeof svgBinary === "object" && svgBinary.encoding === "base64" && svgBinary.data_base64) {
+            svgString = Buffer.from(svgBinary.data_base64, "base64").toString("utf-8");
+        }
+        // Build the enriched chart payload for the UI
+        const uiPayload = {
+            ...chartData,
+            _svg_base: svgString,
+            _birth_params: {
+                datetime,
+                timezone: args.timezone ?? null,
+                latitude: lat ?? null,
+                longitude: lon ?? null,
+                location: args.location ?? null,
+            },
+            house_system: houseSystem,
+        };
+        // Build human-readable summary for the LLM context / fallback text
+        const summary = buildChartSummary(chartData, String(args.location ?? `${lat}, ${lon}`));
+        // Check if the UI bundle is available
+        const bundleAvailable = Boolean(getChartWheelBundle());
+        if (bundleAvailable) {
+            // Return: text fallback + JSON payload + resource reference
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    { type: "text", text: JSON.stringify(uiPayload) },
+                    {
+                        type: "resource",
+                        resource: {
+                            uri: CHART_WHEEL_RESOURCE_URI,
+                            mimeType: CHART_WHEEL_MIME_TYPE,
+                            text: "[Chart Wheel Explorer UI]",
+                        },
+                    },
+                ],
+                _meta: {
+                    ui: { resourceUri: CHART_WHEEL_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text summary + static SVG image block
+        const content = [
+            { type: "text", text: summary },
+        ];
+        if (svgString) {
+            const b64 = Buffer.from(svgString).toString("base64");
+            content.push({ type: "image", data: b64, mimeType: "image/svg+xml" });
+        }
+        return { content };
+    },
+});
+// ── Tool: chart_wheel_on_planet_click ──────────────────────────────────────
+registerTool({
+    name: "chart_wheel_on_planet_click",
+    description: "Event handler called when the user clicks a planet in the interactive chart wheel. " +
+        "Provides rich contextual interpretation of the planet's placement — sign, house, " +
+        "aspects, dignity, and what it means for the native. " +
+        "This tool is called automatically by the chart UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet: { type: "string", description: "Planet name (e.g. 'saturn')" },
+            longitude: { type: "number", description: "Ecliptic longitude in degrees" },
+            sign: { type: "string", description: "Zodiac sign the planet occupies" },
+            house: { type: "number", description: "House the planet occupies (1–12)" },
+            retrograde: { type: "boolean", description: "Whether the planet is retrograde" },
+            speed: { type: "number", description: "Daily motion in degrees" },
+        },
+        required: ["planet", "longitude"],
+    },
+    annotations: { title: "Planet Interpretation", readOnlyHint: true, openWorldHint: false },
+    handler: async (args) => {
+        const planet = String(args.planet);
+        const sign = args.sign ? String(args.sign) : zodSignFromLon(Number(args.longitude));
+        const house = args.house ? ` in the ${ordinal(Number(args.house))} house` : "";
+        const retro = args.retrograde ? " (retrograde ℞)" : "";
+        const degree = `${Math.floor(Number(args.longitude) % 30)}° ${sign}`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${capitalize(planet)} at ${degree}${house}${retro}**\n\n` +
+                        interpretPlanetPlacement(planet, sign, Number(args.house ?? 0), Boolean(args.retrograde)),
+                }],
+        };
+    },
+});
+// ── Tool: chart_wheel_on_house_click ──────────────────────────────────────
+registerTool({
+    name: "chart_wheel_on_house_click",
+    description: "Event handler called when the user clicks a house cusp or house number in the chart wheel. " +
+        "Returns the astrological meaning of that house — life area, themes, and the influence " +
+        "of its ruling sign and planet. " +
+        "This tool is called automatically by the chart UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            house_number: { type: "number", description: "House number (1–12)" },
+            sign: { type: "string", description: "Sign on the house cusp" },
+            cusp_longitude: { type: "number", description: "Cusp longitude in degrees" },
+            ruler: { type: "string", description: "Ruling planet of the house sign" },
+        },
+        required: ["house_number"],
+    },
+    annotations: { title: "House Interpretation", readOnlyHint: true, openWorldHint: false },
+    handler: async (args) => {
+        const num = Number(args.house_number);
+        const sign = args.sign ? String(args.sign) : "";
+        const ruler = args.ruler ? String(args.ruler) : "";
+        return {
+            content: [{
+                    type: "text",
+                    text: `**House ${num}${sign ? ` — ${sign} on the cusp` : ""}${ruler ? ` (ruled by ${ruler})` : ""}**\n\n` +
+                        HOUSE_MEANINGS[num] +
+                        (sign ? `\n\n${capitalize(sign)} on this cusp emphasizes ${SIGN_HOUSE_FLAVOR[sign.toLowerCase()] ?? "its natural qualities"} in the matters of this house.` : ""),
+                }],
+        };
+    },
+});
+// ── Tool: chart_wheel_on_aspect_click ────────────────────────────────────
+registerTool({
+    name: "chart_wheel_on_aspect_click",
+    description: "Event handler called when the user clicks an aspect line between planets in the chart wheel. " +
+        "Returns the astrological interpretation of that aspect — its nature, energy, challenges, " +
+        "and integration advice. " +
+        "This tool is called automatically by the chart UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet1: { type: "string" },
+            planet2: { type: "string" },
+            aspect_type: { type: "string", description: "Conjunction, opposition, trine, square, sextile, etc." },
+            orb: { type: "number", description: "Orb in degrees" },
+            applying: { type: "boolean", description: "True if aspect is applying (intensifying)" },
+            angle: { type: "number", description: "Exact aspect angle" },
+        },
+        required: ["planet1", "planet2"],
+    },
+    annotations: { title: "Aspect Interpretation", readOnlyHint: true, openWorldHint: false },
+    handler: async (args) => {
+        const p1 = capitalize(String(args.planet1));
+        const p2 = capitalize(String(args.planet2));
+        const type = args.aspect_type ? String(args.aspect_type) : "aspect";
+        const orb = args.orb != null ? ` (${Number(args.orb).toFixed(1)}° orb)` : "";
+        const timing = args.applying != null ? (args.applying ? " — applying" : " — separating") : "";
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${p1} ${capitalize(type)} ${p2}${orb}${timing}**\n\n` +
+                        interpretAspect(String(args.planet1), String(args.planet2), type, Boolean(args.applying)),
+                }],
+        };
+    },
+});
+// ── Tool: chart_wheel_recalculate ─────────────────────────────────────────
+registerTool({
+    name: "chart_wheel_recalculate",
+    description: "Recalculates the natal chart using a different house system. " +
+        "Called automatically by the chart wheel UI when the user switches house systems. " +
+        "Returns updated chart data including new house cusps and planet house assignments.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: { type: "string", description: "ISO 8601 datetime string" },
+            timezone: { type: "string" },
+            latitude: { type: "number" },
+            longitude: { type: "number" },
+            location: { type: "string" },
+            house_system: {
+                type: "string",
+                enum: ["placidus", "whole_sign", "equal", "koch", "regiomontanus", "campanus"],
+            },
+        },
+        required: ["datetime", "latitude", "longitude", "house_system"],
+    },
+    annotations: { title: "Recalculate Chart", readOnlyHint: true, openWorldHint: false },
+    handler: async (args) => {
+        const client = getActiveClient();
+        const houseSystem = String(args.house_system);
+        const datetime = String(args.datetime);
+        const lat = args.latitude;
+        const lon = args.longitude;
+        const natalBody = buildNatalBody(datetime, lat, lon, houseSystem, args.timezone);
+        const [chartData, svgBinary] = await Promise.all([
+            client.post("/ephemeris/natal-chart", natalBody),
+            client.post(`/visualization/chart-wheel?format=svg&size=800`, { ...natalBody, style: "light" }).catch(() => null),
+        ]);
+        let svgString = null;
+        if (svgBinary && typeof svgBinary === "object" && svgBinary.encoding === "base64" && svgBinary.data_base64) {
+            svgString = Buffer.from(svgBinary.data_base64, "base64").toString("utf-8");
+        }
+        const uiPayload = {
+            ...chartData,
+            _svg_base: svgString,
+            _birth_params: {
+                datetime,
+                timezone: args.timezone ?? null,
+                latitude: lat ?? null,
+                longitude: lon ?? null,
+                location: args.location ?? null,
+            },
+            house_system: houseSystem,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(uiPayload) }],
+        };
+    },
+});
+// ── Interpretation helpers ────────────────────────────────────────────────
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function ordinal(n) {
+    const s = ["th", "st", "nd", "rd"];
+    const v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+}
+function zodSignFromLon(lon) {
+    const signs = ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+        "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"];
+    return signs[Math.floor(((lon % 360) + 360) % 360 / 30)];
+}
+function buildChartSummary(data, location) {
+    // The natal API returns planets as a keyed object { sun: {...}, moon: {...} }.
+    // Normalise to an array before processing.
+    const raw = data.planets ?? {};
+    const planetsArray = Array.isArray(raw)
+        ? raw
+        : Object.entries(raw).map(([name, p]) => ({
+            name,
+            sign: p.sign,
+            house: p.house,
+            retrograde: Boolean(p.retrograde),
+        }));
+    const lines = planetsArray.slice(0, 10).map((p) => `• **${capitalize(p.name)}** in ${p.sign ?? "?"} (H${p.house ?? "?"})${p.retrograde ? " ℞" : ""}`);
+    return (`**Natal Chart — ${location}**\n\n` +
+        `Key Placements:\n${lines.join("\n")}\n\n` +
+        "Click any planet, house, or aspect line for interpretation.");
+}
+function interpretPlanetPlacement(planet, sign, house, retrograde) {
+    const PLANET_THEMES = {
+        sun: "identity, vitality, and ego expression",
+        moon: "emotional nature, instincts, and early conditioning",
+        mercury: "communication style, thinking patterns, and learning",
+        venus: "love language, values, aesthetics, and relationships",
+        mars: "drive, ambition, aggression, and desire",
+        jupiter: "expansion, luck, philosophy, and higher meaning",
+        saturn: "discipline, limitations, karmic lessons, and mastery",
+        uranus: "innovation, rebellion, sudden change, and originality",
+        neptune: "dreams, spirituality, dissolution, and transcendence",
+        pluto: "transformation, power, death/rebirth, and the unconscious",
+    };
+    const theme = PLANET_THEMES[planet.toLowerCase()] ?? "its archetypal themes";
+    const houseContext = house ? ` Its energy is channeled through the ${ordinal(house)} house, the sphere of ${HOUSE_AREAS[house] ?? "life experience"}.` : "";
+    const retroContext = retrograde
+        ? " Being retrograde, this planet's energy turns inward — its themes are processed more privately and may require more deliberate integration."
+        : "";
+    return (`${capitalize(planet)} rules ${theme}. In ${capitalize(sign)}, it expresses through ${SIGN_QUALITIES[sign.toLowerCase()] ?? "this sign's qualities"}.` +
+        houseContext +
+        retroContext);
+}
+function interpretAspect(planet1, planet2, type, applying) {
+    const ASPECT_NATURE = {
+        conjunction: "creates an intense fusion of these two planetary energies. Their themes blend and amplify each other, for better or worse depending on the planets involved.",
+        opposition: "creates a polarity that demands integration. The challenge is finding balance between these two forces rather than projecting one onto others.",
+        trine: "creates an easy, flowing exchange of energy between these planets. Natural talents and opportunities arise where these themes intersect.",
+        square: "creates productive tension that demands action. This friction is uncomfortable but drives growth and achievement when channeled constructively.",
+        sextile: "creates an opportunistic connection. The gifts here require some effort to activate but reward that effort generously.",
+        quincunx: "creates an awkward inconjunction where these energies struggle to integrate. Ongoing adjustment and flexibility are required.",
+        semisquare: "creates a mild but persistent irritant that, consciously worked with, builds resilience and skill.",
+    };
+    const nature = ASPECT_NATURE[type.toLowerCase()] ?? "creates a notable connection between these energies.";
+    const timing = applying
+        ? "This is an applying aspect, meaning its themes are intensifying and moving toward full expression."
+        : "This is a separating aspect — its peak influence has passed, and its lessons are being integrated.";
+    return (`The ${type} between ${capitalize(planet1)} and ${capitalize(planet2)} ${nature}\n\n${timing}`);
+}
+// ── Static lookup tables ──────────────────────────────────────────────────
+const HOUSE_AREAS = {
+    1: "self, appearance, and beginnings",
+    2: "money, values, and material resources",
+    3: "communication, siblings, and local travel",
+    4: "home, family, roots, and psychological foundations",
+    5: "creativity, romance, children, and pleasure",
+    6: "work, health, daily routines, and service",
+    7: "partnerships, marriage, and open enemies",
+    8: "transformation, shared resources, sex, and death",
+    9: "philosophy, higher education, travel, and belief",
+    10: "career, public reputation, and authority",
+    11: "friends, groups, hopes, and social causes",
+    12: "solitude, the unconscious, karma, and hidden matters",
+};
+const HOUSE_MEANINGS = {
+    1: "The 1st house (Ascendant) governs the self: physical appearance, first impressions, personality, and the mask worn for the world. It marks the beginning of life's journey and how we project ourselves outward.",
+    2: "The 2nd house governs personal resources: money, possessions, earning capacity, and core values. It shows what the native finds security in and how they relate to material comfort.",
+    3: "The 3rd house governs communication, the intellect, siblings, neighbors, and short-distance travel. It reflects how the mind processes and exchanges information.",
+    4: "The 4th house (IC) governs home, family of origin, roots, and the inner emotional world. It represents foundations — both the house you grew up in and your psychological home base.",
+    5: "The 5th house governs creativity, self-expression, romance, children, play, and risk-taking. It is the house of the heart's joy and authentic creative output.",
+    6: "The 6th house governs daily work, health, routines, and service. It reflects the native's relationship with discipline, the body, and supporting others through practical means.",
+    7: "The 7th house (Descendant) governs committed partnerships — marriage, business partners, and close one-on-one relationships. It also shows qualities we project onto others or attract through opposition.",
+    8: "The 8th house governs transformation, other people's resources, inheritances, taxes, sexuality, and the cycle of death and rebirth. It is the house of deep psychological change.",
+    9: "The 9th house governs philosophy, religion, higher education, long-distance travel, and the search for meaning. It expands the mind beyond the familiar.",
+    10: "The 10th house (Midheaven) governs career, public reputation, authority, and life calling. It represents the highest visible achievement and how the world sees the native professionally.",
+    11: "The 11th house governs friendships, groups, social networks, collective causes, and long-term hopes. It reflects where we find belonging in the wider community.",
+    12: "The 12th house governs solitude, the unconscious, hidden enemies, spiritual matters, and undoing. It holds what is repressed, sacrificed, or developed through inner work and retreat.",
+};
+const SIGN_QUALITIES = {
+    aries: "directness, initiative, and pioneering courage",
+    taurus: "steady determination, sensory pleasure, and practical patience",
+    gemini: "curiosity, adaptability, and intellectual versatility",
+    cancer: "emotional depth, nurturing instincts, and protective sensitivity",
+    leo: "bold self-expression, generosity, and regal confidence",
+    virgo: "precision, discernment, and devoted service to improvement",
+    libra: "harmony-seeking, relational grace, and aesthetic refinement",
+    scorpio: "intense focus, emotional depth, and transformative power",
+    sagittarius: "philosophical expansiveness, optimism, and adventurous seeking",
+    capricorn: "disciplined ambition, structural mastery, and long-term commitment",
+    aquarius: "innovative originality, humanitarian vision, and detached idealism",
+    pisces: "compassionate empathy, spiritual receptivity, and imaginative flow",
+};
+const SIGN_HOUSE_FLAVOR = {
+    aries: "initiative and directness",
+    taurus: "patience and material stability",
+    gemini: "intellectual curiosity and communication",
+    cancer: "emotional nurturing and memory",
+    leo: "creative expression and leadership",
+    virgo: "analytical precision and service",
+    libra: "balance and relationship dynamics",
+    scorpio: "depth, intensity, and transformation",
+    sagittarius: "expansion and philosophical seeking",
+    capricorn: "discipline, structure, and achievement",
+    aquarius: "innovation, groups, and humanitarian ideals",
+    pisces: "compassion, dreams, and dissolution of boundaries",
+};

package/dist/tools/dev.js

@@ -68,7 +68,6 @@ registerTool({
         "  GET  /eclipse/solar/global             — Next global solar eclipse (query: date=YYYY-MM-DD)\n" +
         "  GET  /eclipse/solar/local              — Local solar eclipse (query: lat, lon)\n" +
         "  GET  /tidal/forcing                    — Gravitational tidal forcing index\n" +
-        "  GET  /tidal/forcing/deep-time          — Extended tidal deep-time analysis\n" +
         "  POST /acg/power-lines                 — Astrocartography power lines (lat/lon GeoJSON)\n" +
         "  POST /acg/hits                         — ACG power at a specific location\n" +
         "  GET  /calendar/astrology/moon-phases   — Moon phase calendar for a date range\n" +