@openephemeris/mcp-server 3.13.9 → 3.14.0

package/dist/tools/apps/transit-timeline-app.d.ts

@@ -0,0 +1,20 @@
+/**
+ * transit-timeline-app.ts — MCP App tool registration for the Transit Timeline Explorer.
+ *
+ * Registers 1 tool:
+ *   • explore_transit_timeline — primary entry point, returns data + UI resource [model]
+ *
+ * The timeline is rendered client-side from structured JSON — the tool reuses
+ * the existing `ephemeris_transits` handler logic to compute natal chart positions
+ * and search for transit events, then returns the data with a UI resource link
+ * so the iframe can render a Gantt-style timeline.
+ *
+ * Also exports resource helpers (getTransitTimelineBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+export declare const TRANSIT_TIMELINE_RESOURCE_URI = "ui://openephemeris/transit-timeline";
+export declare const TRANSIT_TIMELINE_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getTransitTimelineBundle(): string | null;
+/** Reset cache (useful in dev watch mode or tests). */
+export declare function clearTransitTimelineBundleCache(): void;

package/dist/tools/apps/transit-timeline-app.js

@@ -0,0 +1,295 @@
+/**
+ * transit-timeline-app.ts — MCP App tool registration for the Transit Timeline Explorer.
+ *
+ * Registers 1 tool:
+ *   • explore_transit_timeline — primary entry point, returns data + UI resource [model]
+ *
+ * The timeline is rendered client-side from structured JSON — the tool reuses
+ * the existing `ephemeris_transits` handler logic to compute natal chart positions
+ * and search for transit events, then returns the data with a UI resource link
+ * so the iframe can render a Gantt-style timeline.
+ *
+ * Also exports resource helpers (getTransitTimelineBundle, 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, validateRequired, SERVER_VERSION } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
+// ── Constants ─────────────────────────────────────────────────────────────────
+export const TRANSIT_TIMELINE_RESOURCE_URI = "ui://openephemeris/transit-timeline";
+export const TRANSIT_TIMELINE_MIME_TYPE = "text/html;profile=mcp-app";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATHS = [
+    path.resolve(here, "..", "..", "..", "dist", "ui", "transit-timeline.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 getTransitTimelineBundle() {
+    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 clearTransitTimelineBundleCache() {
+    cachedBundle = null;
+}
+// ── Summary builder ──────────────────────────────────────────────────────────
+function buildTransitSummary(natalPositions, transitResult, aspectAngle, startDate, endDate) {
+    const transits = Array.isArray(transitResult)
+        ? transitResult
+        : (transitResult?.events ?? transitResult?.transits ?? transitResult?.results ?? []);
+    const count = transits.length;
+    const planets = [...new Set(transits.map((t) => String(t.planet ?? "")).filter(Boolean))];
+    const natalPoints = Object.keys(natalPositions);
+    const aspectLabel = aspectAngle === 0 ? "conjunction" : aspectAngle === 180 ? "opposition" : aspectAngle === 90 ? "square" : aspectAngle === 120 ? "trine" : aspectAngle + "°";
+    let summary = "**Transit Timeline — " + startDate + " to " + endDate + "**\n\n" +
+        count + " transit event" + (count !== 1 ? "s" : "") + " found";
+    if (aspectAngle !== 0) {
+        summary += " (" + aspectLabel + " aspect)";
+    }
+    summary += ".\n";
+    if (planets.length > 0) {
+        summary += "Transiting planets: " + planets.join(", ") + "\n";
+    }
+    if (natalPoints.length > 0) {
+        summary += "Natal points targeted: " + natalPoints.join(", ") + "\n";
+    }
+    summary += "\nClick any transit bar on the timeline for details and interpretation.";
+    return summary;
+}
+// ── Tool: explore_transit_timeline ────────────────────────────────────────────
+registerTool({
+    name: "explore_transit_timeline",
+    description: "Generate an interactive transit timeline visualization showing astrological transit events " +
+        "as a visual Gantt chart. Each transit appears as a colored bar on a time axis, grouped by " +
+        "transiting planet, with markers at exact aspect moments.\n\n" +
+        "This tool first calculates the natal chart to extract planetary longitudes, then searches " +
+        "for transiting planets crossing those degrees during the specified date range.\n\n" +
+        "SUPPORTED BODIES: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, " +
+        "Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode.\n\n" +
+        "ASPECT ANGLES: 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine.\n\n" +
+        "Use this for a rich, interactive transit visualization in MCP Apps-capable hosts (Claude Desktop). " +
+        "Falls back to a text summary in other hosts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            natal_datetime: {
+                type: "string",
+                description: "ISO 8601 birth datetime for the natal chart.",
+            },
+            natal_latitude: {
+                type: "number",
+                description: "Latitude of birth location in decimal degrees.",
+            },
+            natal_longitude: {
+                type: "number",
+                description: "Longitude of birth location in decimal degrees.",
+            },
+            start_date: {
+                type: "string",
+                description: "Start of the transit search window, ISO 8601 date or datetime.",
+            },
+            end_date: {
+                type: "string",
+                description: "End of the transit search window, ISO 8601 date or datetime.",
+            },
+            transiting_planets: {
+                type: "array",
+                items: { type: "string" },
+                description: "List of transiting planet IDs to search. Omit to search all outer planets.",
+            },
+            natal_points: {
+                type: "array",
+                items: { type: "string" },
+                description: "Natal point IDs whose longitudes should be targeted. Omit for all core points.",
+            },
+            aspect_angle: {
+                type: "number",
+                description: "Aspect angle in degrees. 0 = conjunction (default), 180 = opposition, 90 = square, 120 = trine.",
+            },
+        },
+        required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
+        additionalProperties: false,
+    },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: {
+        title: "Interactive Transit Timeline Explorer",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    _meta: {
+        ui: {
+            resourceUri: TRANSIT_TIMELINE_RESOURCE_URI,
+            visibility: ["model", "app"],
+        },
+    },
+    handler: async (args) => {
+        validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
+        const client = getActiveClient();
+        // Guard: reject excessively wide date ranges before hitting the backend.
+        // The Go backend clamps Explorer tier to 1 year, but larger tiers can still
+        // trigger compute-bound 45-second timeouts on very wide windows.
+        const startMs = new Date(args.start_date).getTime();
+        const endMs = new Date(args.end_date).getTime();
+        if (!isNaN(startMs) && !isNaN(endMs)) {
+            const spanDays = (endMs - startMs) / (1000 * 60 * 60 * 24);
+            if (spanDays > 5 * 365) {
+                throw new Error(`Date range too wide (${Math.round(spanDays / 365)} years). ` +
+                    `The transit timeline works best with windows under 2 years — try narrowing ` +
+                    `start_date and end_date to a 1–2 year window and re-run.`);
+            }
+        }
+        // Step 1: Compute natal chart to extract 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 client.request("POST", "/ephemeris/natal-chart", { data: natalBody });
+        const targetDegrees = [];
+        const natalPositionMap = {};
+        const planets = natalResult?.planets || natalResult?.data?.planets || [];
+        const planetArray = Array.isArray(planets) ? planets : Object.values(planets);
+        // ── Core natal points to target (conjunction search) ─────────────────────
+        // When no natal_points filter is given, we limit to 7 core bodies to keep
+        // target_degrees count manageable. 4 outer planets × 10+ targets creates a
+        // combinatoric explosion (40+ serial SearchTransit calls on the backend).
+        const CORE_BODIES_DEFAULT = new Set([
+            "sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn",
+        ]);
+        const wantedPoints = args.natal_points
+            ? new Set(args.natal_points.map((p) => p.toLowerCase()))
+            : CORE_BODIES_DEFAULT;
+        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.has(name))
+                continue;
+            targetDegrees.push(Math.round(lon * 100) / 100);
+            natalPositionMap[name] = lon;
+        }
+        // Extract angles (ASC, MC) — only if explicitly requested via natal_points
+        if (args.natal_points) {
+            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.has(name))
+                        continue;
+                    targetDegrees.push(Math.round(lon * 100) / 100);
+                    natalPositionMap[name] = lon;
+                }
+            }
+        }
+        // Safety cap: never send more than 12 target degrees to the backend
+        // (prevents combinatoric timeouts when many planets + many targets overlap).
+        const MAX_TARGETS = 12;
+        if (targetDegrees.length > MAX_TARGETS) {
+            targetDegrees.splice(MAX_TARGETS);
+            // Prune natalPositionMap to match
+            const keepNames = new Set(Object.entries(natalPositionMap)
+                .filter(([, v]) => targetDegrees.includes(Math.round(v * 100) / 100))
+                .map(([k]) => k));
+            for (const k of Object.keys(natalPositionMap)) {
+                if (!keepNames.has(k))
+                    delete natalPositionMap[k];
+            }
+        }
+        if (targetDegrees.length === 0) {
+            throw new Error("Could not extract natal planet longitudes. Verify natal_datetime, natal_latitude, and natal_longitude.");
+        }
+        // Step 2: Search transits
+        let startStr = args.start_date;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(startStr))
+            startStr += "T00:00:00Z";
+        let endStr = args.end_date;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(endStr))
+            endStr += "T23:59:59Z";
+        const aspectAngle = typeof args.aspect_angle === "number" ? args.aspect_angle : 0;
+        let effectiveTargets = targetDegrees;
+        if (aspectAngle !== 0) {
+            effectiveTargets = targetDegrees.map((deg) => ((deg + aspectAngle) % 360 + 360) % 360);
+        }
+        const transitBody = {
+            start_date: startStr,
+            end_date: endStr,
+            target_degrees: effectiveTargets,
+        };
+        if (args.transiting_planets)
+            transitBody.planet_names = args.transiting_planets;
+        if (aspectAngle !== 0) {
+            transitBody.search_criteria = { aspect_angle: aspectAngle };
+        }
+        // Give the backend a 90s window — explorer tier allows 30s Go compute
+        // timeout, but the node-to-Fly round-trip including queuing can extend this.
+        const transitResult = await client.request("POST", "/predictive/transits/search", { data: transitBody, timeoutMs: 90_000 });
+        // Normalize the API response into a flat array so the iframe UI always
+        // receives an iterable — some backend response shapes wrap events in a
+        // container object rather than returning a bare array.
+        const transitArray = Array.isArray(transitResult)
+            ? transitResult
+            : (transitResult?.events ??
+                transitResult?.transits ??
+                transitResult?.results ??
+                []);
+        // Build payload
+        const payload = {
+            natal_positions: natalPositionMap,
+            target_degrees_used: effectiveTargets,
+            aspect_angle: aspectAngle,
+            transit_results: transitArray,
+            search_window: { start_date: args.start_date, end_date: args.end_date },
+            server_version: SERVER_VERSION,
+        };
+        const summary = buildTransitSummary(natalPositionMap, transitArray, aspectAngle, args.start_date, args.end_date);
+        const bundleAvailable = Boolean(getTransitTimelineBundle());
+        if (bundleAvailable) {
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    { type: "text", text: JSON.stringify(payload) },
+                ],
+                _meta: {
+                    "ui/resourceUri": TRANSIT_TIMELINE_RESOURCE_URI,
+                    ui: { resourceUri: TRANSIT_TIMELINE_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text summary only
+        return { content: [{ type: "text", text: summary }] };
+    },
+});

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

@@ -0,0 +1,17 @@
+/**
+ * vedic-chart-app.ts — MCP App tool registration for the Vedic Jyotish Chart Explorer.
+ *
+ * Registers 1 tool:
+ *   • explore_vedic_chart — primary entry point [model + app visible]
+ *     Calls POST /vedic/chart and returns a data payload + UI resource URI
+ *     so Claude Desktop can render the interactive South Indian Rashi grid.
+ *
+ * Also exports resource helpers (getVedicChartBundle, etc.) for use in
+ * server-sse.ts resource listing and reading.
+ */
+export declare const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
+export declare const VEDIC_CHART_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getVedicChartBundle(): string | null;
+/** Reset cache (useful in dev watch mode or tests). */
+export declare function clearVedicChartBundleCache(): void;

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

@@ -0,0 +1,228 @@
+/**
+ * vedic-chart-app.ts — MCP App tool registration for the Vedic Jyotish Chart Explorer.
+ *
+ * Registers 1 tool:
+ *   • explore_vedic_chart — primary entry point [model + app visible]
+ *     Calls POST /vedic/chart and returns a data payload + UI resource URI
+ *     so Claude Desktop can render the interactive South Indian Rashi grid.
+ *
+ * Also exports resource helpers (getVedicChartBundle, etc.) for use in
+ * server-sse.ts resource listing and reading.
+ */
+import fs from "node:fs";
+import path from "node:path";
+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";
+// ── Constants ─────────────────────────────────────────────────────────────────
+export const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
+export const VEDIC_CHART_MIME_TYPE = "text/html;profile=mcp-app";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATHS = [
+    path.resolve(here, "..", "..", "..", "dist", "ui", "vedic-chart.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 getVedicChartBundle() {
+    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 clearVedicChartBundleCache() {
+    cachedBundle = null;
+}
+function parseVedicArgs(args) {
+    const { datetime, latitude, longitude, ayanamsa } = args;
+    if (!datetime) {
+        throw new Error("datetime is required. Provide an ISO 8601 datetime in UTC, " +
+            "e.g. datetime='1987-07-15T14:30:00Z'.");
+    }
+    if (latitude == null || longitude == null) {
+        throw new Error("latitude and longitude are required for Vedic chart calculation. " +
+            "Example: latitude=28.6, longitude=77.2 (New Delhi).");
+    }
+    return { datetime, latitude, longitude, ayanamsa: ayanamsa || undefined };
+}
+// ── Summary builder ──────────────────────────────────────────────────────────
+// Convert a sidereal longitude (0–360°) to the Western sign name
+function lonToSignName(lon) {
+    const SIGNS = [
+        "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+        "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces",
+    ];
+    const idx = Math.floor(((lon % 360) + 360) % 360 / 30) % 12;
+    return SIGNS[idx];
+}
+function buildVedicSummary(data) {
+    const planets = data.planets || [];
+    const metadata = data.metadata || {};
+    // lagna is a degree float from the backend — convert to sign name
+    const lagnaSign = typeof metadata.lagna === "number"
+        ? lonToSignName(metadata.lagna)
+        : metadata.lagna || "unknown";
+    // Backend returns "ayanamsha" (with extra h) — normalise
+    const ayanamsa = metadata.ayanamsa || metadata.ayanamsha || "Lahiri";
+    const ayanamsaVal = metadata.ayanamsa_value != null
+        ? " (" + metadata.ayanamsa_value.toFixed(2) + "°)"
+        : metadata.correction != null
+            ? " (" + metadata.correction.toFixed(2) + "°)"
+            : "";
+    let summary = "**Vedic Jyotish Chart** — Lagna: **" + lagnaSign + "** · Ayanamsa: " +
+        ayanamsa + ayanamsaVal + "\n\n";
+    // Planet placement table
+    if (planets.length > 0) {
+        summary += "| Planet | Rashi | Degree | Nakshatra | Pada |\n";
+        summary += "|--------|-------|--------|-----------|------|\n";
+        for (const p of planets) {
+            const retroMark = p.is_retrograde ? " ℞" : "";
+            summary +=
+                "| " + capFirst(String(p.planet)) + retroMark +
+                    " | " + (p.rashi_western || p.rashi || "?") +
+                    " | " + (typeof p.rashi_degree === "number" ? p.rashi_degree.toFixed(2) + "°" : "?") +
+                    " | " + (p.nakshatra?.name || "?") +
+                    " | " + (p.nakshatra?.pada || "?") +
+                    " |\n";
+        }
+        summary += "\n";
+    }
+    summary += "Click on any Rashi cell to explore the planets placed there.";
+    return summary;
+}
+function capFirst(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+// ── Tool: explore_vedic_chart ─────────────────────────────────────────────────
+registerTool({
+    name: "explore_vedic_chart",
+    description: "Generate an interactive Vedic Jyotish (South Indian) Rashi chart visualization.\n\n" +
+        "Renders a 4×4 fixed-sign grid with:\n" +
+        "  • All nine Jyotish planets (Sun through Ketu) placed in their Rashi\n" +
+        "  • Lagna (Ascendant) cell marked with a gold diagonal\n" +
+        "  • Sanskrit/Devanagari sign labels toggle\n" +
+        "  • Click any Rashi cell → detailed planet info drawer\n" +
+        "    (degree, Nakshatra, Pada, lord, Navamsa sign, dignity)\n" +
+        "  • Ask Claude buttons for Lagna, Moon/Nakshatra, and full chart interpretation\n" +
+        "  • Ayanamsa system displayed (Lahiri by default)\n\n" +
+        "CREDIT COST: 1 credit.\n\n" +
+        "Use this for a rich, interactive Vedic chart experience in MCP Apps-capable hosts " +
+        "(Claude Desktop). Falls back to a markdown table summary in other hosts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: {
+                type: "string",
+                description: "Birth date and time as ISO 8601, e.g. '1987-07-15T14:30:00Z'. " +
+                    "Always include time when known — it determines the Lagna (Ascendant).",
+            },
+            latitude: {
+                type: "number",
+                description: "Birth latitude in decimal degrees, e.g. 28.6 for New Delhi.",
+            },
+            longitude: {
+                type: "number",
+                description: "Birth longitude in decimal degrees, e.g. 77.2 for New Delhi.",
+            },
+            ayanamsa: {
+                type: "string",
+                enum: ["lahiri", "fagan_bradley", "krishnamurti", "raman", "yukteshwar"],
+                description: "Ayanamsa system for sidereal calculation. " +
+                    "Options: 'lahiri' (default, most common), 'raman', 'krishnamurti', 'fagan_bradley', 'yukteshwar'.",
+            },
+        },
+        required: ["datetime", "latitude", "longitude"],
+        additionalProperties: false,
+    },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: {
+        title: "Interactive Vedic Jyotish Chart",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    _meta: {
+        ui: {
+            resourceUri: VEDIC_CHART_RESOURCE_URI,
+            visibility: ["model", "app"],
+        },
+    },
+    handler: async (args) => {
+        const { datetime, latitude, longitude, ayanamsa } = parseVedicArgs(args);
+        const client = getActiveClient();
+        // Backend field is datetime_utc (matches vedic.ts specialized tool)
+        const body = {
+            datetime_utc: datetime,
+            latitude,
+            longitude,
+        };
+        if (ayanamsa)
+            body.ayanamsa = ayanamsa;
+        const result = await client.request("POST", "/vedic/chart", { data: body });
+        const rawMeta = result.metadata || {};
+        // Backend returns lagna as a degree float (e.g. 213.4) but the iframe
+        // expects a sign name string (e.g. "Scorpio") for cell matching.
+        const lagnaRaw = rawMeta.lagna;
+        const lagnaSign = typeof lagnaRaw === "number"
+            ? lonToSignName(lagnaRaw)
+            : lagnaRaw || "";
+        // Backend returns "ayanamsha" (extra h) — normalise to "ayanamsa".
+        const ayanamsaName = rawMeta.ayanamsa || rawMeta.ayanamsha || "Lahiri";
+        const normalizedMeta = {
+            ...rawMeta,
+            lagna: lagnaSign,
+            ayanamsa: ayanamsaName,
+            // Expose correction as ayanamsa_value so the iframe can show the degree
+            ayanamsa_value: rawMeta.ayanamsa_value ?? rawMeta.correction ?? null,
+        };
+        // Build a Set from the retrograde_planets list the Go handler populated.
+        const retrogradeList = Array.isArray(rawMeta.retrograde_planets)
+            ? rawMeta.retrograde_planets
+            : [];
+        const retrogradeSet = new Set(retrogradeList);
+        const uiPayload = {
+            // Stamp is_retrograde on each planet using the retrograde_planets list
+            // from metadata — the Go struct has no such field, so it lives in metadata.
+            planets: (result.planets || []).map((p) => ({
+                ...p,
+                is_retrograde: retrogradeSet.has(String(p.planet)),
+            })),
+            metadata: normalizedMeta,
+            server_version: SERVER_VERSION,
+        };
+        const summary = buildVedicSummary(uiPayload);
+        const bundleAvailable = Boolean(getVedicChartBundle());
+        if (bundleAvailable) {
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    // Second text block is injected as window.__VEDIC_CHART_DATA__ by ext-apps SDK
+                    { type: "text", text: JSON.stringify(uiPayload) },
+                ],
+                _meta: {
+                    "ui/resourceUri": VEDIC_CHART_RESOURCE_URI,
+                    ui: { resourceUri: VEDIC_CHART_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text-only table
+        return { content: [{ type: "text", text: summary }] };
+    },
+});

package/dist/tools/auth.js

@@ -1,6 +1,7 @@
 import { registerTool } from "./index.js";
 import { CredentialManager } from "../auth/credentials.js";
 import { DeviceAuthFlow } from "../auth/device-auth.js";
+import { OUTPUT_SCHEMA_AUTH } from "./output-schemas.js";
 const credentialManager = new CredentialManager();
 // ────────────────────────────────────────────────────────
 // auth.login — Start the device authorization flow
@@ -17,6 +18,7 @@ registerTool({
         properties: {},
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_AUTH,
     annotations: {
         title: "Connect Account",
         readOnlyHint: false,
@@ -95,6 +97,7 @@ registerTool({
         properties: {},
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_AUTH,
     annotations: {
         title: "Auth Status",
         readOnlyHint: true,
@@ -179,6 +182,7 @@ registerTool({
         properties: {},
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_AUTH,
     annotations: {
         title: "Disconnect Account",
         readOnlyHint: false,

package/dist/tools/dev.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "./index.js";
 import { getActiveClient } from "../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "./output-schemas.js";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -123,6 +124,7 @@ registerTool({
         required: ["method", "path"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     handler: async (args) => {
         validateRequired(args, ["path"]);
         const methodStr = String(args.method || "GET").toUpperCase();
@@ -189,6 +191,7 @@ registerTool({
         properties: {},
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     handler: async () => {
         const allowlist = loadAllowlist();
         return {

package/dist/tools/index.d.ts

@@ -5,6 +5,12 @@ export interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: z.ZodType<any> | Record<string, unknown>;
+    /**
+     * MCP spec 2025-11-25 — JSON Schema describing the structured output of this tool.
+     * Smithery uses this to score "Output schemas" in the quality rubric.
+     * All tools return MCP content block arrays; specialized tools declare richer shapes.
+     */
+    outputSchema?: Record<string, unknown>;
     annotations?: {
         title?: string;
         readOnlyHint?: boolean;

package/dist/tools/index.js

@@ -47,7 +47,11 @@ export async function initTools(profile) {
     // Always register the generic proxy tools (dev.call + dev.list_allowed).
     await import("./dev.js");
     if (resolvedProfile === "dev") {
-        // Register all specialized domain tools.
+        // ── FULL BUILD: all specialized tools ───────────────────────────
+        // Payload size theory was disproven. The "Failed to call tool" 
+        // bug was caused by Claude Desktop's MCP App iframe handler 
+        // corruption. Iframe tools are purged; all specialized tools are restored.
+        // ────────────────────────────────────────────────────────────────
         await import("./specialized/natal.js");
         await import("./specialized/transits.js");
         await import("./specialized/moon.js");
@@ -70,11 +74,12 @@ export async function initTools(profile) {
         await import("./specialized/ephemeris_extended.js");
         await import("./specialized/venus_star_points.js");
         await import("./specialized/acg.js");
-        // MCP App tools (interactive UI)
+        await import("./apps/location-tools.js");
+        // Re-enable requested MCP apps (iframes)
         await import("./apps/chart-wheel-app.js");
-        await import("./apps/bodygraph-app.js");
         await import("./apps/bi-wheel-app.js");
-        await import("./apps/location-tools.js");
+        await import("./apps/bodygraph-app.js");
+        await import("./apps/moon-phase-app.js");
     }
 }
 /**