@openephemeris/mcp-server 3.13.6 → 3.13.8

package/dist/tools/apps/bodygraph-app.js

@@ -178,10 +178,17 @@ function buildHdModelPayload(data, birthParams) {
         });
     }
     // Personality / Design gates — API nests them under personality.activations / design.activations
-    const rawP = data.personality?.activations ?? data.personality_gates ?? data.conscious_gates ?? [];
-    const rawD = data.design?.activations ?? data.design_gates ?? data.unconscious_gates ?? [];
-    const personality_gates = [...new Set(extractGateNums(rawP))].sort((a, b) => a - b);
-    const design_gates = [...new Set(extractGateNums(rawD))].sort((a, b) => a - b);
+    // Ensure we pick up the map if available or the array
+    let rawP = data.personality?.activations ?? data.personality_activations ?? data.personality_gates ?? data.conscious_gates ?? {};
+    let rawD = data.design?.activations ?? data.design_activations ?? data.design_gates ?? data.unconscious_gates ?? {};
+    // if rawP/D are objects instead of arrays, extract values for gates array
+    const pGateList = Array.isArray(rawP) ? rawP : Object.values(rawP);
+    const dGateList = Array.isArray(rawD) ? rawD : Object.values(rawD);
+    const personality_gates = [...new Set(extractGateNums(pGateList))].sort((a, b) => a - b);
+    const design_gates = [...new Set(extractGateNums(dGateList))].sort((a, b) => a - b);
+    // keep the maps
+    const personality_activations = !Array.isArray(rawP) && typeof rawP === 'object' ? rawP : undefined;
+    const design_activations = !Array.isArray(rawD) && typeof rawD === 'object' ? rawD : undefined;
     return {
         type,
         profile,
@@ -193,6 +200,8 @@ function buildHdModelPayload(data, birthParams) {
         active_channels,
         personality_gates,
         design_gates,
+        personality_activations,
+        design_activations,
         _birth_params: birthParams,
     };
 }
@@ -242,6 +251,12 @@ registerTool({
                 type: "string",
                 description: "Location name for display only (e.g. 'New York, NY').",
             },
+            timezone: {
+                type: "string",
+                description: "IANA timezone name for the birth location (e.g. 'America/New_York'). " +
+                    "Highly recommended for accuracy if providing local birth time without a UTC offset. " +
+                    "Enables correct UTC conversion for precise Personality and Design positions.",
+            },
         },
         required: ["datetime"],
     },
@@ -286,16 +301,9 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                     { type: "text", text: JSON.stringify({ ...modelPayload, server_version: SERVER_VERSION }) },
-                    {
-                        type: "resource",
-                        resource: {
-                            uri: BODYGRAPH_RESOURCE_URI,
-                            mimeType: BODYGRAPH_MIME_TYPE,
-                            text: getBodygraphBundle(),
-                        },
-                    },
                 ],
                 _meta: {
+                    "ui/resourceUri": BODYGRAPH_RESOURCE_URI,
                     ui: { resourceUri: BODYGRAPH_RESOURCE_URI },
                 },
             };
@@ -304,6 +312,49 @@ registerTool({
         return { content: [{ type: "text", text: summary }] };
     },
 });
+// ── Tool: bodygraph_recalculate ──────────────────────────────────────────────
+registerTool({
+    name: "bodygraph_recalculate",
+    description: "Recalculates a Human Design bodygraph with new parameters.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: { type: "string" },
+            latitude: { type: "number" },
+            longitude: { type: "number" },
+            location: { type: "string" },
+            timezone: {
+                type: "string",
+                description: "IANA timezone name (e.g. 'America/New_York') for accurate UTC conversion.",
+            },
+        },
+        required: ["datetime"],
+    },
+    annotations: { title: "Recalculate Bodygraph", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const client = getActiveClient();
+        const datetime = ensureTimezone(String(args.datetime));
+        const body = {
+            birth_datetime_utc: datetime,
+        };
+        if (args.latitude != null)
+            body.latitude = args.latitude;
+        if (args.longitude != null)
+            body.longitude = args.longitude;
+        const chartData = await client.request("POST", "/human-design/chart", {
+            data: body,
+        });
+        const chart = chartData.chart ?? chartData;
+        const modelPayload = buildHdModelPayload(chart, {
+            datetime,
+            location: args.location ?? null,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify({ ...modelPayload, server_version: SERVER_VERSION }) }],
+        };
+    },
+});
 // ── Tool: hd_on_center_click ──────────────────────────────────────────────
 registerTool({
     name: "hd_on_center_click",
@@ -648,3 +699,301 @@ const HD_CHANNEL_DATA = {
     "59-6": { name: "Intimacy", circuit: "Tribal (Defence)", energy_type: "generated", description: "The channel of intimacy — penetrating auras for mating and reproduction. Emotional authority governing who is let past one's auric boundaries." },
     "60-3": { name: "Mutation", circuit: "Individual (Knowing)", energy_type: "generated", description: "The channel of mutation — energy that transforms through accepted limitation. Initiates new patterns in a discontinuous, pulse-like fashion." },
 };
+// ── Planet biographical themes (shared across tools) ─────────────────────────────
+const HD_PLANET_HD_THEMES = {
+    Sun: {
+        conscious: "The Sun represents your **core life purpose and identity** in HD. The Personality Sun gate is the most important " +
+            "activation in your chart — it is the primary frequency your aura broadcasts into the world. " +
+            "This is the theme you actively embody and are consciously directing through life.",
+        unconscious: "The **Design Sun** is the most powerful unconscious driver in your chart. " +
+            "Calculated 88 days before birth (the prenatal solar arc), it represents a deeply embedded " +
+            "genetic frequency — the way your body moves through the world without conscious awareness. " +
+            "Others will often notice this quality before you do.",
+    },
+    Earth: {
+        conscious: "**Earth** grounds and stabilises your Sun energy. The Personality Earth gate shows the theme " +
+            "that anchors you in material reality — what brings you into your body and provides stability " +
+            "when life becomes unsteady. Working with your Earth gate is a powerful grounding practice.",
+        unconscious: "The **Design Earth** reveals an unconscious grounding force — the energetic counterbalance " +
+            "to your Design Sun. This theme provides biological stability and is deeply wired into your body's functioning.",
+    },
+    Moon: {
+        conscious: "The **Moon** shows the emotional and instinctual flavour of your Personality. " +
+            "This gate reveals the needs, changes, and rhythms you are consciously aware of — " +
+            "what nourishes you emotionally and how you respond to the cycles of life.",
+        unconscious: "The **Design Moon** governs your body's unconscious biological rhythms. " +
+            "It influences your physical cycles, instinctive reactions, and the deeper tides of your body consciousness " +
+            "that operate beneath the surface of your awareness.",
+    },
+    Mercury: {
+        conscious: "**Mercury** shows how your Personality mind communicates. This gate reveals the flavour of your " +
+            "thinking, speaking, and processing — the distinct frequency through which you engage ideas and share your perspective.",
+        unconscious: "**Design Mercury** represents the unconscious communication patterns embedded in your body. " +
+            "These are ways of processing and articulating that others see in you before you notice them in yourself.",
+    },
+    Venus: {
+        conscious: "**Venus** in Human Design represents your Personality's set of values — what you love, what you value, " +
+            "and the principles that guide your aesthetic and ethical choices. This is the code of your heart's standards.",
+        unconscious: "**Design Venus** reveals deep, unconscious values embedded in the body — " +
+            "the instinctive sense of beauty and rightness that operates beneath conscious awareness, " +
+            "often influencing what you are drawn to without knowing why.",
+    },
+    Mars: {
+        conscious: "**Mars** reveals the quality of your immature, unconditioned energy — the raw drive that fuels your actions. " +
+            "In HD it represents a key aspect of the immaturity we carry, which through experience matures " +
+            "into its highest expression. This shows what drives you to act and assert in the world.",
+        unconscious: "**Design Mars** shows the unconscious somatic drive — an instinctive, body-level impulse that moves you " +
+            "to act before the mind has a chance to deliberate. This energy can surprise even yourself.",
+    },
+    Jupiter: {
+        conscious: "**Jupiter** represents the law of your Personality — the karmic gifts and the areas of life where " +
+            "higher wisdom, abundance, and justice flow. It shows where and how you expand beyond the self-limiting " +
+            "patterns of your conditioning.",
+        unconscious: "**Design Jupiter** shows the unconscious grace embedded in your design — the karmic correction " +
+            "your body naturally applies when you are living true to your nature.",
+    },
+    Saturn: {
+        conscious: "**Saturn** in HD is the law of the Personality — the karmic discipline and structure that teaches " +
+            "through limitation. This is where and how you are tested — and where, when discipline is met, " +
+            "mastery and authority are earned.",
+        unconscious: "**Design Saturn** shows the unconscious discipline encoded in the body — restrictions and structures " +
+            "that operate below awareness, shaping what the body instinctively avoids or seeks to master.",
+    },
+    Uranus: {
+        conscious: "**Uranus** represents the Personality's awakening theme — the particular flavour of disruption, " +
+            "innovation, and revolution that is uniquely yours. Where this gate activates, you may be ahead of your time.",
+        unconscious: "**Design Uranus** shows the collective mutation frequency encoded in the body — " +
+            "an unconscious genius that may awaken suddenly, or a restlessness that drives the body toward change without obvious reason.",
+    },
+    Neptune: {
+        conscious: "**Neptune** represents the Personality's visionary or confusional theme — where dreams, ideals, " +
+            "and illusions are most acutely felt. This gate shows where you seek transcendence and how you navigate glamour vs. clarity.",
+        unconscious: "**Design Neptune** shows a deep unconscious spiritual frequency — " +
+            "a channel through which higher ideals and subtle realities filter into the body below the threshold of awareness.",
+    },
+    Pluto: {
+        conscious: "**Pluto** represents the Personality's evolutionary theme — the irreversible transformation that defines " +
+            "your generation's karmic task. This gate shows where you are destined to encounter, survive, and embody profound change.",
+        unconscious: "**Design Pluto** shows the collective transformation frequency embedded deep in the body — " +
+            "an unconscious driver of evolutionary pressure that often manifests as crisis, catharsis, or deep cellular-level transformation.",
+    },
+    "North Node": {
+        conscious: "The **North Node** in Human Design represents your Personality's karmic direction — " +
+            "the evolutionary frontier you are meant to move toward in this lifetime. " +
+            "This gate describes the territory of growth, the unfamiliar that calls you forward.",
+        unconscious: "The **Design North Node** shows the unconscious genetic direction — " +
+            "the biological path forward that the body moves toward instinctively, often without conscious recognition.",
+    },
+    "South Node": {
+        conscious: "The **South Node** represents the Personality's karmic past — " +
+            "the themes of prior experience and natural gifts that can become comfortable traps if over-relied upon. " +
+            "This gate shows the territory of ingrained habit and the origin point of this life's journey.",
+        unconscious: "The **Design South Node** shows the unconscious genetic inheritance — " +
+            "deeply instilled somatic patterns and reflexes from ancestral or past-life experience, operating beneath awareness.",
+    },
+    Chiron: {
+        conscious: "**Chiron** in Human Design is the Wounded Healer archetype — " +
+            "the gate where deepest vulnerability resides, and where the greatest potential for mastery and healing lives. " +
+            "The wound and the gift are inseparable here.",
+        unconscious: "**Design Chiron** shows an unconscious wound carried in the body — " +
+            "a somatic tenderness that, when honoured rather than suppressed, becomes the source of profound empathy and healing capacity.",
+    },
+};
+// ── Tool: hd_on_planet_click ─────────────────────────────────────────────────────────
+registerTool({
+    name: "hd_on_planet_click",
+    description: "Event handler called when the user clicks a planet row in the Personality or Design sidebar column " +
+        "of the Human Design Bodygraph. " +
+        "Returns the planet's archetypal meaning in Human Design, its Personality vs Design context " +
+        "(conscious vs unconscious), the gate/line it activates, and an interpretation of that placement. " +
+        "This tool is called automatically by the bodygraph UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet: {
+                type: "string",
+                description: "Planet name (e.g. 'Sun', 'Moon', 'Mars', 'Chiron').",
+            },
+            gate: {
+                type: "number",
+                description: "Gate number this planet activates (1–64).",
+            },
+            line: {
+                type: "number",
+                description: "I Ching line number (1–6).",
+            },
+            column: {
+                type: "string",
+                enum: ["personality", "design"],
+                description: "Which column the planet is in — 'personality' (conscious/black) or 'design' (unconscious/red).",
+            },
+        },
+        required: ["planet", "column"],
+    },
+    annotations: { title: "Planet Sidebar Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const planet = String(args.planet);
+        const gate = args.gate != null ? Number(args.gate) : null;
+        const line = args.line != null ? Number(args.line) : null;
+        const column = String(args.column ?? "personality");
+        const isPersonality = column === "personality";
+        const columnLabel = isPersonality ? "Personality (Conscious)" : "Design (Unconscious)";
+        const columnColor = isPersonality ? "🔴" : "⚪";
+        const lineRef = line != null ? `.${line}` : "";
+        const gateRef = gate != null ? ` → Gate ${gate}${lineRef}` : "";
+        const gateInfo = gate != null ? HD_GATE_DATA[gate] : null;
+        const planetHD = HD_PLANET_HD_THEMES[planet];
+        const planetContext = planetHD
+            ? (isPersonality ? planetHD.conscious : planetHD.unconscious)
+            : `${capitalize(planet)} activates the themes of the gate it touches in this column.`;
+        const gateContext = gateInfo
+            ? (`\n\n**Gate ${gate}${lineRef} — ${gateInfo.name}**\n` +
+                `${gateInfo.keynote}\n\n` +
+                `**Gift:** ${gateInfo.gift}  \n**Shadow:** ${gateInfo.shadow}  \n**Circuit:** ${gateInfo.circuit}` +
+                (line != null && gateInfo.lines?.[line] ? `\n\n**Line ${line}:** ${gateInfo.lines[line]}` : ""))
+            : (gate != null ? `\n\nGate ${gate}${lineRef} activates in this column.` : "");
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${capitalize(planet)}${gateRef}** ${columnColor} *${columnLabel}*\n\n` +
+                        planetContext +
+                        gateContext,
+                }],
+        };
+    },
+});
+// ── Tool: hd_on_variable_click ───────────────────────────────────────────────────────
+registerTool({
+    name: "hd_on_variable_click",
+    description: "Event handler called when the user clicks a Variable arrow in the Human Design Bodygraph. " +
+        "The Variable describes the four arrow directions attached to the Personality Sun/Earth " +
+        "and Design Sun/Earth positions, encoding the PHS (Primary Health System) — the optimal conditions " +
+        "for the body-mind to receive information and make decisions. " +
+        "Returns an interpretation of Digestion (right/left Personality Sun arrow), " +
+        "Perspective (right/left Personality Earth arrow), " +
+        "Environment (right/left Design Sun arrow), and Motivation (right/left Design Earth arrow). " +
+        "This tool is called automatically by the bodygraph UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            variable: {
+                type: "string",
+                enum: ["digestion", "perspective", "environment", "motivation"],
+                description: "Which of the four Variable arrows was clicked.",
+            },
+            direction: {
+                type: "string",
+                enum: ["left", "right"],
+                description: "Arrow direction: 'right' = Right Variable (passive/receptive), 'left' = Left Variable (active/assertive).",
+            },
+            tone: {
+                type: "number",
+                description: "The specific tone (1–6) of this Variable, if available from the activation.",
+            },
+            color: {
+                type: "number",
+                description: "The specific color (1–6) of this Variable, if available from the activation.",
+            },
+        },
+        required: ["variable", "direction"],
+    },
+    annotations: { title: "Variable Arrow Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const variable = String(args.variable).toLowerCase();
+        const direction = String(args.direction).toLowerCase();
+        const tone = args.tone != null ? Number(args.tone) : null;
+        const color = args.color != null ? Number(args.color) : null;
+        const VARIABLE_DATA = {
+            digestion: {
+                right: "**Right Digestion** (Passive/Receptive) \u2014 Your body receives nourishment best in a passive, open way. " +
+                    "This means eating in environments that feel calm and familiar, allowing appetite to arise naturally, " +
+                    "and avoiding forced, rushed, or emotionally charged eating. Quality, timing, and atmosphere matter enormously. " +
+                    "Right Digestion types are often sensitive to the subtleties of environment — " +
+                    "the right conditions allow optimal absorption of both food and information.",
+                left: "**Left Digestion** (Active/Assertive) \u2014 Your body operates best when you engage actively with what you consume. " +
+                    "This means initiating eating rather than waiting, eating in variety and stimulation, " +
+                    "and being drawn by appetite and desire rather than routine. " +
+                    "Left Digestion types often thrive with more novelty, conversation, and engagement at the table — " +
+                    "your body needs to be activated, not passively nourished.",
+                tones: {
+                    1: "Tone 1 — Consecutive: best with orderly, sequential eating — simple and unvaried meals in a fixed rhythm.",
+                    2: "Tone 2 — Alternating: eat a variety of foods but alternate types — not all mixed together.",
+                    3: "Tone 3 — Cyclic: allow the body to cycle through periods of different dietary focuses.",
+                    4: "Tone 4 — Calm: eat only when the emotional atmosphere is calm and undisturbed.",
+                    5: "Tone 5 — Open: eat in open spaces or with good air circulation; avoid enclosed or stagnant settings.",
+                    6: "Tone 6 — Closed: eat in private, quiet, familiar environments — protected from public exposure.",
+                },
+            },
+            perspective: {
+                right: "**Right Perspective** (Personal) \u2014 Your mind is designed to receive wisdom and truth through personal, " +
+                    "lived experience. This is a *Receptive* perspective — the mind is best employed reading the world " +
+                    "from within your own direct experience rather than abstractly theorizing about what should be.",
+                left: "**Left Perspective** (Transpersonal) \u2014 Your mind is designed to understand patterns beyond the personal. " +
+                    "This is an *Active* perspective — the mind is naturally drawn toward understanding systems, " +
+                    "humanity, and abstract principles. You often see what others need before seeing your own needs.",
+            },
+            environment: {
+                right: "**Right Environment** (Passive/Receptive) \u2014 Your body thrives in environments that are " +
+                    "familiar, stable, and comfortable — places that feel safe and known. " +
+                    "This is a Receptive environment variable: your nervous system functions best in predictable territory " +
+                    "rather than constant novelty. Forcing yourself into overly stimulating or unknown environments " +
+                    "can deplete your health and decision-making capacity over time.",
+                left: "**Left Environment** (Active/Assertive) \u2014 Your body thrives by moving through diverse, " +
+                    "stimulating environments. This is an Active environment variable: you are designed to encounter " +
+                    "variety, new places, and fresh stimulation. Being too long in the same environment can lead to " +
+                    "stagnation, restlessness, or decreased vitality.",
+                tones: {
+                    1: "Tone 1 — Caves: you do best in enclosed, cozy, cave-like environments with shelter overhead.",
+                    2: "Tone 2 — Markets: you thrive in places of exchange and activity — social, commercial, varied.",
+                    3: "Tone 3 — Kitchens: hearth-centered environments — where nourishment and community gather.",
+                    4: "Tone 4 — Mountains: elevated, expansive, airy environments with altitude and horizon.",
+                    5: "Tone 5 — Valleys: sheltered, low, protected geographies — river valleys, low land, sheltered bays.",
+                    6: "Tone 6 — Shores: boundary environments — coast, lakeside, edge-of-land — where elements meet.",
+                },
+            },
+            motivation: {
+                right: "**Right Motivation** (Receptive) \u2014 Your decision-making and life direction are best guided " +
+                    "by following the inner call of your Strategy and Authority — moving toward what naturally draws you " +
+                    "in rather than forcing or pursuing. Your correct motivation is essentially trustful and receptive.",
+                left: "**Left Motivation** (Active) \u2014 Your decision-making is best guided by active, intentional pursuit " +
+                    "of what aligns with your values and strategy. You are designed to initiate and drive toward what matters to you — " +
+                    "though always filtered through your Authority to ensure the body’s wisdom is guiding the mind.",
+                tones: {
+                    1: "Tone 1 — Fear: the motivation to move away from what limits or threatens, turning fear into healthy caution.",
+                    2: "Tone 2 — Hope: the motivation toward a better, more expanded future possibility.",
+                    3: "Tone 3 — Desire: the motivation driven by genuine wanting and attraction.",
+                    4: "Tone 4 — Need: the motivation arising from a felt sense of lack or necessity.",
+                    5: "Tone 5 — Guilt: the motivation arising from responsibility to others and the tribe.",
+                    6: "Tone 6 — Innocence: the motivation of pure openness, not knowing, and beginner’s mind.",
+                },
+            },
+        };
+        const info = VARIABLE_DATA[variable];
+        if (!info) {
+            return {
+                content: [{ type: "text", text: `**Variable: ${capitalize(variable)} (${capitalize(direction)})**\n\nVariable data not available for this arrow.` }],
+            };
+        }
+        const main = direction === "right" ? info.right : info.left;
+        const toneNote = tone != null && info.tones?.[tone]
+            ? `\n\n**Your Specific Tone (${tone}):** ${info.tones[tone]}`
+            : "";
+        const colorNote = color != null
+            ? `\n\n**Color ${color}** subtly modulates this Variable's expression — these nuances are covered in advanced PHS reading.`
+            : "";
+        const label = `${capitalize(variable)} Arrow — ${capitalize(direction)} Variable`;
+        const icon = variable === "digestion" ? "🔵" : variable === "perspective" ? "🟢" : variable === "environment" ? "⚪" : "🔴";
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${label}** ${icon}\n\n` +
+                        main + toneNote + colorNote +
+                        "\n\n*The Variable is a refinement layer within the Primary Health System (PHS). " +
+                        "It describes the optimal conditions for the body-brain to receive and process information correctly. " +
+                        "Living according to your Variable is an advanced practice that supports deeper health, clarity, and cognitive accuracy.*",
+                }],
+        };
+    },
+});

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

@@ -182,16 +182,9 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                     { type: "text", text: JSON.stringify({ ...modelPayload, server_version: SERVER_VERSION }) },
-                    {
-                        type: "resource",
-                        resource: {
-                            uri: CHART_WHEEL_RESOURCE_URI,
-                            mimeType: CHART_WHEEL_MIME_TYPE,
-                            text: getChartWheelBundle(),
-                        },
-                    },
                 ],
                 _meta: {
+                    "ui/resourceUri": CHART_WHEEL_RESOURCE_URI,
                     ui: { resourceUri: CHART_WHEEL_RESOURCE_URI },
                 },
             };
@@ -312,13 +305,13 @@ registerTool({
 // ── 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.",
+    description: "Recalculates the natal chart, solar return, or progressed chart with new parameters (house system, date, location). " +
+        "Called automatically by the chart wheel UI when the user updates the controls. " +
+        "Returns updated chart data including new house cusps and planet assignments.",
     inputSchema: {
         type: "object",
         properties: {
-            datetime: { type: "string", description: "ISO 8601 datetime string" },
+            datetime: { type: "string", description: "ISO 8601 natal datetime string" },
             timezone: { type: "string", description: "IANA timezone name (e.g. 'America/New_York')" },
             latitude: { type: "number", description: "Birth latitude in decimal degrees (positive = North)" },
             longitude: { type: "number", description: "Birth longitude in decimal degrees (positive = East)" },
@@ -328,6 +321,15 @@ registerTool({
                 enum: ["placidus", "whole_sign", "equal", "koch", "regiomontanus", "campanus"],
                 description: "House system to recalculate with (e.g. 'whole_sign')",
             },
+            chart_type: {
+                type: "string",
+                enum: ["natal", "solar_return", "progressed"],
+                description: "Type of chart to calculate. Defaults to natal."
+            },
+            target_datetime: {
+                type: "string",
+                description: "ISO 8601 target datetime string. Reguired for solar_return or progressed calculations."
+            }
         },
         required: ["datetime", "latitude", "longitude", "house_system"],
     },
@@ -339,23 +341,34 @@ registerTool({
         const datetime = String(args.datetime);
         const lat = args.latitude;
         const lon = args.longitude;
-        const natalBody = buildNatalBody(datetime, lat, lon, houseSystem, args.timezone);
+        const chartType = args.chart_type ?? "natal";
+        const baseBody = buildNatalBody(datetime, lat, lon, houseSystem, args.timezone);
+        let endpoint = "/ephemeris/natal-chart";
+        let requestBody = baseBody;
+        if (chartType === "solar_return") {
+            endpoint = "/predictive/returns/solar";
+            requestBody.configuration.target_datetime = { iso: args.target_datetime ?? datetime };
+        }
+        else if (chartType === "progressed") {
+            endpoint = "/predictive/progressed";
+            requestBody.configuration.target_datetime = { iso: args.target_datetime ?? datetime };
+            requestBody.configuration.method = "secondary";
+        }
         // Fetch updated chart JSON only — chart renders client-side in the iframe
-        const chartData = await client.post("/ephemeris/natal-chart", natalBody);
-        // Return only chart data (no SVG) — the UI calls chart_wheel_fetch_svg
-        const payload = {
-            ...chartData,
-            _birth_params: {
-                datetime,
-                timezone: args.timezone ?? null,
-                latitude: lat ?? null,
-                longitude: lon ?? null,
-                location: args.location ?? null,
-            },
-            house_system: houseSystem,
-        };
+        const chartData = await client.post(endpoint, requestBody);
+        // Normalise through buildModelPayload so house-switch results use the same
+        // format as the initial response.
+        const payload = buildModelPayload(chartData, {
+            datetime,
+            timezone: args.timezone ?? null,
+            latitude: lat ?? null,
+            longitude: lon ?? null,
+            location: args.location ?? null,
+            chartType: chartType,
+            targetDatetime: args.target_datetime ?? null
+        }, houseSystem);
         return {
-            content: [{ type: "text", text: JSON.stringify(payload) }],
+            content: [{ type: "text", text: JSON.stringify({ ...payload, server_version: SERVER_VERSION }) }],
         };
     },
 });
@@ -443,7 +456,7 @@ function buildModelPayload(chartData, birthParams, houseSystem, svgBase) {
             speed: (p.longitude_speed ?? p.speed),
             retrograde: Boolean(p.is_retrograde ?? p.retrograde),
             sign: (p.sign_name ?? p.sign),
-            house: (p.house),
+            house: (p.house_number ?? p.house),
         }));
     }
     else if (Array.isArray(chartData.planets)) {
@@ -452,8 +465,29 @@ function buildModelPayload(chartData, birthParams, houseSystem, svgBase) {
     }
     // ── 2. Compute aspects from longitude data (API doesn't return them) ──────
     const aspects = computeAspects(planetsArray);
+    // ── 3. Extract angles — API nests ascendant/MC under an `angles` key ──────
+    const rawAngles = chartData.angles;
+    const rawHouseObj = chartData.houses;
+    const ascendant = rawAngles?.ascendant ??
+        chartData.ascendant ??
+        rawHouseObj?.cusps?.[0] ??
+        0;
+    const midheaven = rawAngles?.midheaven ??
+        chartData.midheaven ??
+        rawHouseObj?.cusps?.[9] ??
+        0;
+    // ── 4. Convert houses object → HouseData[] array ──────────────────────────
+    // API returns { cusps: [lon0, lon1, …lon11], system: "P" }.
+    // The chart-wheel UI expects HouseData[] = [{ number:1, cusp_lon }, …].
+    const housesArray = (rawHouseObj?.cusps ?? []).map((cusp, i) => ({
+        number: i + 1,
+        cusp_lon: cusp,
+    }));
     return {
-        ...chartData,
+        ascendant,
+        midheaven,
+        chart_ruler: chartData.chart_ruler,
+        houses: housesArray,
         // Typed array replaces the keyed object — the renderer can now iterate it
         planets: planetsArray,
         // Structured aspect array — powers highlighting and info panel
@@ -473,7 +507,7 @@ function buildChartSummary(data, location) {
         : Object.entries(raw).map(([name, p]) => ({
             name,
             sign: (p.sign_name ?? p.sign),
-            house: p.house,
+            house: (p.house_number ?? p.house),
             retrograde: Boolean(p.is_retrograde ?? p.retrograde),
             longitude: p.longitude,
             longitude_speed: p.longitude_speed,

package/dist/tools/apps/location-tools.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/apps/location-tools.js

@@ -0,0 +1,52 @@
+import { registerTool, validateRequired } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+registerTool({
+    name: "location_search",
+    description: "App-only tool for getting location autocomplete suggestions. Returns latitude, longitude, and IANA timezone.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query for location, e.g. 'Los Angeles'",
+            },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    },
+    _meta: {
+        ui: {
+            visibility: ["app"],
+        },
+    },
+    handler: async (args) => {
+        validateRequired(args, ["query"]);
+        return await getActiveClient().request("GET", "/location/autocomplete", {
+            params: { q: args.query },
+        });
+    },
+});
+registerTool({
+    name: "timezone_resolve",
+    description: "App-only tool for resolving IANA timezone by latitude and longitude.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            latitude: { type: "number" },
+            longitude: { type: "number" },
+        },
+        required: ["latitude", "longitude"],
+        additionalProperties: false,
+    },
+    _meta: {
+        ui: {
+            visibility: ["app"],
+        },
+    },
+    handler: async (args) => {
+        validateRequired(args, ["latitude", "longitude"]);
+        return await getActiveClient().request("GET", "/timezone/lookup", {
+            params: { lat: args.latitude.toString(), lon: args.longitude.toString() },
+        });
+    },
+});

package/dist/tools/index.js

@@ -74,6 +74,7 @@ export async function initTools(profile) {
         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");
     }
 }
 /**

package/dist/tools/specialized/acg.js

@@ -54,6 +54,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude"]);
         const body = {
@@ -146,6 +147,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"]);
         const body = {