@openephemeris/mcp-server 4.7.0 → 4.8.1

package/dist/tools/specialized/hd_group.js

@@ -53,7 +53,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["person_a_datetime", "person_b_datetime"]);
         const body = {
@@ -123,7 +123,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Penta Group Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Penta Group Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["group_name", "members"]);
         const members = await Promise.all(args.members.map(async (m, i) => ({

package/dist/tools/specialized/human_design.js

@@ -62,7 +62,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/moon.js

@@ -6,20 +6,16 @@ import { localToUtcIsoHistorical } from "../datetime-historical.js";
 registerTool({
     name: "ephemeris_moon_phase",
     description: "Get the Moon's current phase angle, illumination, sign and void-of-course status AT a " +
-        "specific point in time. Returns phase name (New, Waxing Crescent, First Quarter, etc.), exact " +
-        "angle, illumination %, the zodiac sign and degree the Moon occupies, and next void-of-course " +
-        "period.\n\n" +
+        "specific point in time. Returns phase name (New, Waxing Crescent, etc.), illumination %, " +
+        "the zodiac sign and degree the Moon occupies, and next void-of-course period.\n\n" +
         "⚠️  THIS TOOL ANSWERS: 'What phase is the moon in right now (or at a given datetime)?' and " +
         "'What sign is the moon in?'\n" +
         "❌  THIS TOOL DOES NOT ANSWER: 'When is the next new moon / full moon?'\n" +
         "→   For upcoming phase DATES use ephemeris_next_lunar_phase instead.\n\n" +
         "For a user-facing interactive moon-phase dial, use explore_moon_phase instead.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
-        "If no datetime is provided, returns the current (live) moon phase.\n\n" +
-        "EXAMPLE: Get moon phase for a specific date/time:\n" +
-        "  datetime='2026-03-20T12:00:00Z'\n\n" +
-        "EXAMPLE: Get the current moon phase right now:\n" +
-        "  (call with no arguments)",
+        "CREDIT COST: 2 credits — phase and void-of-course are metered separately. For " +
+        "phase alone at 1 credit, use dev_read_api path='/ephemeris/moon/phase'.\n\n" +
+        "If no datetime is provided, returns the current (live) moon phase.",
     inputSchema: {
         type: "object",
         properties: {
@@ -43,7 +39,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateCoordinates(args, "latitude", "longitude");
         const params = {};
@@ -74,8 +70,9 @@ registerTool({
         "'What date is the next quarter moon?', or any question about UPCOMING phase dates.\n" +
         "❌  NOT FOR: 'What phase is the moon in right now?' or 'What sign is the moon in?'\n" +
         "→   For the phase, sign and degree AT a moment, use ephemeris_moon_phase.\n\n" +
-        "CREDIT COST: about 1 credit per occurrence returned — count=1 costs 1 credit, " +
-        "count=3 costs 3.\n\n" +
+        "CREDIT COST: 1-2 credits per occurrence returned — each occurrence takes one " +
+        "calendar search, plus a second search when the first window misses. So count=3 " +
+        "costs 3-6 credits.\n\n" +
         "EXAMPLE: Find the next new moon:\n" +
         "  phase='new_moon'\n\n" +
         "EXAMPLE: Find the next full moon after a specific date:\n" +
@@ -107,7 +104,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Next Lunar Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Next Lunar Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const PHASE_LABELS = {
             new_moon: "New Moon",

package/dist/tools/specialized/natal.js

@@ -73,7 +73,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         assertZonedDatetime("datetime", args.datetime, args.timezone);

package/dist/tools/specialized/progressed.js

@@ -60,7 +60,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Progressed Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Progressed Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"]);
         assertZonedDatetime("birth_datetime", args.birth_datetime, args.timezone);

package/dist/tools/specialized/relocation.js

@@ -51,7 +51,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Relocation Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Relocation Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"]);
         assertZonedDatetime("natal_datetime", args.natal_datetime, args.timezone);

package/dist/tools/specialized/returns.js

@@ -63,7 +63,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Solar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Solar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         assertZonedDatetime("birth_datetime", args.birth_datetime, args.timezone);
@@ -136,7 +136,7 @@ registerTool({
     },
     // JSON only: this tool never sets include_visual, so it cannot return an image.
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Lunar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Lunar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         assertZonedDatetime("birth_datetime", args.birth_datetime, args.timezone);
@@ -196,7 +196,7 @@ registerTool({
     },
     // JSON only: this tool never sets include_visual, so it cannot return an image.
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["body", "birth_datetime", "target_datetime"]);
         assertZonedDatetime("birth_datetime", args.birth_datetime, args.timezone);

package/dist/tools/specialized/synastry.js

@@ -57,7 +57,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Synastry Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Synastry Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",

package/dist/tools/specialized/transits.js

@@ -64,7 +64,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Transit Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Transit Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
         // ── Step 1: Compute natal chart to extract real planetary longitudes ──

package/dist/tools/specialized/vedic.js

@@ -38,7 +38,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Vedic Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Vedic Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         validateCoordinates(args, "latitude", "longitude");

package/dist/tools/specialized/venus_star_points.js

@@ -35,7 +35,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus Star Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus Star Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         assertZonedDatetime("datetime", args.datetime, args.timezone);
@@ -67,7 +67,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus Conjunctions", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus Conjunctions", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date"]);
         const query = {};
@@ -98,7 +98,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus 8-Year Star", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus 8-Year Star", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["date"]);
         const query = {};
@@ -130,7 +130,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const query = {};
         if (args.format)
@@ -158,7 +158,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus Elongations", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus Elongations", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date"]);
         const query = {};
@@ -189,7 +189,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Venus Stations", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Venus Stations", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["start_date"]);
         const query = {};

package/dist/ui/chart-wheel.html

@@ -7690,8 +7690,8 @@ function Cy(e5) {
 vy.ontoolresult = (e5) => {
   var t2;
   let n2 = ny(e5);
-  if (qy(), !n2 || !n2.planets) {
-    console.error("[ChartWheel] \u274C No chart data found in tool result"), Jy("Chart data could not be parsed from the server response.", Yy);
+  if (Jy(), !n2 || !n2.planets) {
+    console.error("[ChartWheel] \u274C No chart data found in tool result"), Yy("Chart data could not be parsed from the server response.", Xy);
     return;
   }
   if ($ = n2, yy = (t2 = n2.house_system) == null ? "placidus" : t2, !by) {
@@ -7718,9 +7718,9 @@ vy.ontoolresult = (e5) => {
 };
 function wy(e5) {
   var t2, n2, r2, i2, a2, o2, s2;
-  ky = null, ly.setAttribute("hidden", ""), uy.removeAttribute("hidden"), _y.removeAttribute("hidden"), py.removeAttribute("hidden"), zv(uy, e5, Ly, Ry, zy, Wy, Sy ? By() : void 0), mv(Cy), Hv(py, yy, Gy), Ty(e5), ty("chart-wheel", uy);
+  Ay = null, ly.setAttribute("hidden", ""), uy.removeAttribute("hidden"), _y.removeAttribute("hidden"), py.removeAttribute("hidden"), zv(uy, e5, Ry, zy, By, Gy, Sy ? Vy() : void 0), mv(Cy), Hv(py, yy, Ky), Ey(e5), ty("chart-wheel", uy);
   let c2 = K_(e5.planets), l2 = (n2 = (r2 = (i2 = ((t2 = e5.houses) == null ? [] : t2)[0]) == null ? void 0 : i2.cusp_lon) == null ? e5.ascendant : r2) == null ? 0 : n2, u2 = (a2 = e5.aspects) == null ? [] : a2;
-  c2.length > 0 && Dy(c2, u2), Ay(cv(u2, c2), c2, l2), Fy();
+  c2.length > 0 && Oy(c2, u2), jy(cv(u2, c2), c2, l2), Iy();
   let d2 = document.getElementById("cw-action-bar");
   if (!d2) {
     d2 = document.createElement("div"), d2.id = "cw-action-bar", d2.className = "hd-action-bar";
@@ -7731,9 +7731,12 @@ function wy(e5) {
       (f2 = document.getElementById("app")) == null || f2.prepend(d2);
     }
   }
-  d2.innerHTML = '\n    <button class="action-btn action-btn--primary" id="cw-interpret-btn">\u2728 Interpret this chart</button>\n    <button class="action-btn" id="cw-questions-btn">\u{1F52E} What should I ask?</button>\n  ', (o2 = document.getElementById("cw-interpret-btn")) == null || o2.addEventListener("click", () => void Hy()), (s2 = document.getElementById("cw-questions-btn")) == null || s2.addEventListener("click", () => void Uy());
+  d2.innerHTML = '\n    <button class="action-btn action-btn--primary" id="cw-interpret-btn">\u2728 Interpret this chart</button>\n    <button class="action-btn" id="cw-questions-btn">\u{1F52E} What should I ask?</button>\n  ', (o2 = document.getElementById("cw-interpret-btn")) == null || o2.addEventListener("click", () => void Uy()), (s2 = document.getElementById("cw-questions-btn")) == null || s2.addEventListener("click", () => void Wy());
 }
 function Ty(e5) {
+  return String(e5).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function Ey(e5) {
   var t2, n2, r2, i2, a2, o2, s2, c2, l2, u2;
   if (!dy) return;
   let d2 = (t2 = e5._birth_params) == null ? {} : t2, f2 = (n2 = (r2 = (i2 = d2.datetime) == null ? e5.datetime : i2) == null ? e5.birth_datetime : r2) == null ? "" : n2, p2 = (a2 = (o2 = d2.location) == null ? e5.location : o2) == null ? "" : a2, m2 = (s2 = (c2 = d2.timezone) == null ? e5.timezone : c2) == null ? "" : s2, h2 = (l2 = d2.latitude) == null ? e5.latitude : l2, g2 = (u2 = d2.longitude) == null ? e5.longitude : u2;
@@ -7747,14 +7750,14 @@ function Ty(e5) {
   } catch (e6) {
   }
   let y2 = typeof h2 == "number" && typeof g2 == "number" ? "".concat(Math.abs(h2).toFixed(2), "\xB0").concat(h2 >= 0 ? "N" : "S", ", ").concat(Math.abs(g2).toFixed(2), "\xB0").concat(g2 >= 0 ? "E" : "W") : "", b2 = [];
-  if (ee2 && b2.push('<span class="info-chip" title="Birth datetime">\u{1F4C5} '.concat(ee2, "</span>")), p2 && b2.push('<span class="info-chip" title="Birth location">\u{1F4CD} '.concat(p2, "</span>")), y2 && !p2 && b2.push('<span class="info-chip" title="Coordinates">\u{1F4CD} '.concat(y2, "</span>")), m2 && b2.push('<span class="info-chip" title="Timezone">\u{1F550} '.concat(m2, "</span>")), v2 && b2.push('<span class="info-chip sect" title="Sect">'.concat(v2, "</span>")), b2.length === 0) {
+  if (ee2 && b2.push('<span class="info-chip" title="Birth datetime">\u{1F4C5} '.concat(Ty(ee2), "</span>")), p2 && b2.push('<span class="info-chip" title="Birth location">\u{1F4CD} '.concat(Ty(p2), "</span>")), y2 && !p2 && b2.push('<span class="info-chip" title="Coordinates">\u{1F4CD} '.concat(Ty(y2), "</span>")), m2 && b2.push('<span class="info-chip" title="Timezone">\u{1F550} '.concat(Ty(m2), "</span>")), v2 && b2.push('<span class="info-chip sect" title="Sect">'.concat(Ty(v2), "</span>")), b2.length === 0) {
     dy.setAttribute("hidden", "");
     return;
   }
   dy.innerHTML = b2.join(""), dy.removeAttribute("hidden");
 }
-var Ey = /* @__PURE__ */ new Set(["mean_lilith", "lilith", "true_lilith", "ceres", "juno", "vesta", "pallas", "pholus", "vertex", "part_of_fortune", "part of fortune", "eris", "sedna"]);
-function Dy(e5, t2) {
+var Dy = /* @__PURE__ */ new Set(["mean_lilith", "lilith", "true_lilith", "ceres", "juno", "vesta", "pallas", "pholus", "vertex", "part_of_fortune", "part of fortune", "eris", "sedna"]);
+function Oy(e5, t2) {
   if (!gy || e5.length === 0) return;
   let n2 = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto", "chiron", "north node", "south node", "true node"], r2 = [...e5].sort((e6, t3) => {
     let r3 = n2.indexOf(e6.name.toLowerCase()), i3 = n2.indexOf(t3.name.toLowerCase());
@@ -7766,7 +7769,7 @@ function Dy(e5, t2) {
   }
   let s2 = (e6) => e6.replace(/(^|\s|_)\w/g, (e7) => e7.toUpperCase()).replace(/_/g, " "), c2 = (e6) => ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"][Math.floor((e6 % 360 + 360) % 360 / 30)], l2 = r2.map((e6) => {
     var t3, n3, r3, a3;
-    let o3 = e6.name.toLowerCase(), l3 = (t3 = j_[o3]) == null ? "\u2605" : t3, u3 = (n3 = e6.sign) == null ? c2(e6.longitude) : n3, d3 = Math.floor((e6.longitude % 360 + 360) % 360 % 30), f3 = Math.floor((e6.longitude % 360 + 360) % 360 % 1 * 60), p3 = Ey.has(o3), m2 = e6.retrograde ? '<span class="retro-mark">\u211E</span>' : "", h2 = (r3 = i2[o3]) == null ? 0 : r3;
+    let o3 = e6.name.toLowerCase(), l3 = (t3 = j_[o3]) == null ? "\u2605" : t3, u3 = (n3 = e6.sign) == null ? c2(e6.longitude) : n3, d3 = Math.floor((e6.longitude % 360 + 360) % 360 % 30), f3 = Math.floor((e6.longitude % 360 + 360) % 360 % 1 * 60), p3 = Dy.has(o3), m2 = e6.retrograde ? '<span class="retro-mark">\u211E</span>' : "", h2 = (r3 = i2[o3]) == null ? 0 : r3;
     return '<tr class="'.concat(p3 ? "extended-row" : "", '" data-planet="').concat(o3, '">\n      <td><span class="planet-sym">').concat(l3, "</span> ").concat(s2(e6.name)).concat(m2, "</td>\n      <td>").concat(d3, "\xB0 ").concat(u3, " ").concat(String(f3).padStart(2, "0"), "\u2032</td>\n      <td>H").concat((a3 = e6.house) == null ? "\u2013" : a3, "</td>\n      <td>").concat(h2 > 0 ? h2 : "\u2013", "</td>\n    </tr>");
   }).join(""), u2 = "| Body | Sign | Degree | House | Retrograde |\n| --- | --- | --- | --- | --- |\n" + r2.map((e6) => {
     var t3;
@@ -7784,7 +7787,7 @@ function Dy(e5, t2) {
         d2.textContent = "Copy", d2.classList.remove("copied");
       }, 1600);
     } catch (e7) {
-      Oy("Copy unavailable");
+      ky("Copy unavailable");
     }
   });
   let f2 = gy.querySelector(".overview-toggle"), p2 = gy.querySelector(".overview-body");
@@ -7803,7 +7806,7 @@ function Dy(e5, t2) {
       let t4 = document.querySelector("svg");
       t4 && (t4.querySelectorAll(".planet-glyph-group").forEach((e7) => {
         var t5;
-        let n4 = Ey.has((t5 = e7.dataset.planet) == null ? "" : t5);
+        let n4 = Dy.has((t5 = e7.dataset.planet) == null ? "" : t5);
         e7.style.opacity = n4 ? "0.65" : "1";
       }), e6.classList.remove("active-row"));
     }), e6.addEventListener("click", () => {
@@ -7814,7 +7817,7 @@ function Dy(e5, t2) {
     }));
   });
 }
-function Oy(e5) {
+function ky(e5) {
   var t2;
   (t2 = document.getElementById("copy-toast")) == null || t2.remove();
   let n2 = document.createElement("div");
@@ -7822,8 +7825,8 @@ function Oy(e5) {
     n2.classList.remove("visible"), setTimeout(() => n2.remove(), 300);
   }, 2500);
 }
-var ky = null;
-function Ay(e5, t2, n2) {
+var Ay = null;
+function jy(e5, t2, n2) {
   if (!my) return;
   if (e5.length === 0) {
     my.setAttribute("hidden", ""), my.innerHTML = "";
@@ -7838,10 +7841,10 @@ function Ay(e5, t2, n2) {
     let t3 = document.createElement("button");
     t3.className = "pattern-ask-claude-btn", t3.textContent = "\u2728 Ask Claude", t3.style.display = "none", my.appendChild(t3), t3.addEventListener("click", () => {
       var n3;
-      let r3 = ky;
+      let r3 = Ay;
       if (r3 === null) return;
       let i2 = e5[r3];
-      t3.disabled = true, t3.textContent = "\u23F3 Sending\u2026", Wy({ type: "pattern", data: { name: i2.name, planets: i2.planets, description: (n3 = i2.description) == null ? "" : n3 } }).then(() => {
+      t3.disabled = true, t3.textContent = "\u23F3 Sending\u2026", Gy({ type: "pattern", data: { name: i2.name, planets: i2.planets, description: (n3 = i2.description) == null ? "" : n3 } }).then(() => {
         t3.textContent = "\u2713 Sent", setTimeout(() => {
           t3.textContent = "\u2728 Ask Claude", t3.disabled = false;
         }, 2500);
@@ -7854,12 +7857,12 @@ function Ay(e5, t2, n2) {
     r3.addEventListener("click", () => {
       var i2;
       let a2 = Number(r3.dataset.idx), o2 = e5[a2], s2 = (i2 = r3.dataset.color) == null ? "#888" : i2, c2 = my.querySelector(".pattern-ask-claude-btn");
-      ky === a2 ? (ky = null, Mv(), c2 && (c2.style.display = "none"), my.querySelectorAll(".pattern-pill").forEach((e6) => {
+      Ay === a2 ? (Ay = null, Mv(), c2 && (c2.style.display = "none"), my.querySelectorAll(".pattern-pill").forEach((e6) => {
         var t3;
         e6.classList.remove("active");
         let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
         e6.style.color = n3, e6.style.borderColor = n3, e6.style.background = "transparent";
-      })) : (ky = a2, my.querySelectorAll(".pattern-pill").forEach((e6) => {
+      })) : (Ay = a2, my.querySelectorAll(".pattern-pill").forEach((e6) => {
         var t3;
         e6.classList.remove("active");
         let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
@@ -7868,8 +7871,8 @@ function Ay(e5, t2, n2) {
     });
   });
 }
-var jy = [{ label: "Tight", maxOrb: 4 }, { label: "Standard", maxOrb: 8 }, { label: "Wide", maxOrb: 12 }], My = true, Ny = 8, Py = "true";
-function Fy() {
+var My = [{ label: "Tight", maxOrb: 4 }, { label: "Standard", maxOrb: 8 }, { label: "Wide", maxOrb: 12 }], Ny = true, Py = 8, Fy = "true";
+function Iy() {
   var e5;
   if (!hy) return;
   let t2 = (() => {
@@ -7881,9 +7884,9 @@ function Fy() {
     let n3 = t3.some((e7) => e7 === "north node" || e7 === "north node (mean)" || e7 === "mean node"), r3 = t3.some((e7) => e7 === "true node" || e7 === "north node (true)");
     return n3 && r3;
   })();
-  W_(Py);
-  let n2 = t2 ? '\n      <div class="asp-section">\n        <span class="asp-section-label">Nodes</span>\n        <button class="orb-preset-btn node-btn'.concat(Py === "mean" ? " active" : "", '" data-node="mean" title="Mean lunar node (averaged orbit)">Mean</button>\n        <button class="orb-preset-btn node-btn').concat(Py === "true" ? " active" : "", '" data-node="true" title="True (osculating) lunar node">True</button>\n      </div>') : "";
-  My = true, hy.innerHTML = '\n    <div class="asp-panel">\n      <div class="asp-section">\n        <span class="asp-section-label">Aspects</span>\n        <button class="aspect-toggle-btn active" id="cw-aspect-vis-toggle"\n          title="Toggle all natal aspect lines">\n          <span class="toggle-icon">\u2295</span> Natal aspects\n        </button>\n      </div>\n      <div class="asp-section">\n        <span class="asp-section-label">Orb</span>\n        '.concat(jy.map((e6) => '<button class="orb-preset-btn'.concat(e6.maxOrb === Ny ? " active" : "", '" data-orb="').concat(e6.maxOrb, '" title="').concat(e6.label, ' orbs">').concat(e6.label, "</button>")).join(""), "\n      </div>").concat(n2, "\n    </div>\n  ");
+  W_(Fy);
+  let n2 = t2 ? '\n      <div class="asp-section">\n        <span class="asp-section-label">Nodes</span>\n        <button class="orb-preset-btn node-btn'.concat(Fy === "mean" ? " active" : "", '" data-node="mean" title="Mean lunar node (averaged orbit)">Mean</button>\n        <button class="orb-preset-btn node-btn').concat(Fy === "true" ? " active" : "", '" data-node="true" title="True (osculating) lunar node">True</button>\n      </div>') : "";
+  Ny = true, hy.innerHTML = '\n    <div class="asp-panel">\n      <div class="asp-section">\n        <span class="asp-section-label">Aspects</span>\n        <button class="aspect-toggle-btn active" id="cw-aspect-vis-toggle"\n          title="Toggle all natal aspect lines">\n          <span class="toggle-icon">\u2295</span> Natal aspects\n        </button>\n      </div>\n      <div class="asp-section">\n        <span class="asp-section-label">Orb</span>\n        '.concat(My.map((e6) => '<button class="orb-preset-btn'.concat(e6.maxOrb === Py ? " active" : "", '" data-orb="').concat(e6.maxOrb, '" title="').concat(e6.label, ' orbs">').concat(e6.label, "</button>")).join(""), "\n      </div>").concat(n2, "\n    </div>\n  ");
   let r2 = K_($ == null ? void 0 : $.planets), i2 = /* @__PURE__ */ new Set(), a2 = [];
   for (let e6 of r2) {
     let t3 = e6.name.toLowerCase();
@@ -7902,21 +7905,21 @@ function Fy() {
   hy.insertAdjacentHTML("beforeend", Kv([{ title: "Bodies", items: a2 }, { title: "Aspects", items: o2 }])), hy.removeAttribute("hidden");
   let s2 = document.getElementById("cw-aspect-vis-toggle");
   s2 == null || s2.addEventListener("click", () => {
-    My = !My, Lv(My), s2.classList.toggle("active", My), s2.querySelector(".toggle-icon").textContent = My ? "\u2295" : "\u2296";
+    Ny = !Ny, Lv(Ny), s2.classList.toggle("active", Ny), s2.querySelector(".toggle-icon").textContent = Ny ? "\u2295" : "\u2296";
   }), hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e6) => {
     e6.addEventListener("click", () => {
       var t3;
       let n3 = parseFloat((t3 = e6.dataset.orb) == null ? "8" : t3);
-      n3 !== Ny && (Ny = n3, hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e7) => e7.classList.toggle("active", e7.dataset.orb === String(n3))), Rv(n3));
+      n3 !== Py && (Py = n3, hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e7) => e7.classList.toggle("active", e7.dataset.orb === String(n3))), Rv(n3));
     });
   }), hy.querySelectorAll(".node-btn").forEach((e6) => {
     e6.addEventListener("click", () => {
       let t3 = e6.dataset.node === "mean" ? "mean" : "true";
-      t3 === Py || !$ || (Py = t3, W_(t3), wy($));
+      t3 === Fy || !$ || (Fy = t3, W_(t3), wy($));
     });
   });
 }
-async function Iy(e5, t2) {
+async function Ly(e5, t2) {
   if (xy) try {
     let n2 = "[Chart Wheel] Selected ".concat(e5, " \u2014 ").concat(Object.entries(t2).filter(([, e6]) => e6 != null && e6 !== false && e6 !== "").map(([e6, t3]) => "".concat(e6, ": ").concat(t3)).join(", "));
     await vy.updateModelContext({ content: [{ type: "text", text: n2 }] });
@@ -7924,24 +7927,24 @@ async function Iy(e5, t2) {
     console.warn("[ChartWheel] \u26A0\uFE0F updateModelContext failed:", e6);
   }
 }
-async function Ly(e5) {
+async function Ry(e5) {
   var t2, n2, r2, i2;
-  ky = null, my == null || my.querySelectorAll(".pattern-pill").forEach((e6) => {
+  Ay = null, my == null || my.querySelectorAll(".pattern-pill").forEach((e6) => {
     var t3;
     e6.classList.remove("active");
     let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
     e6.style.color = n3, e6.style.borderColor = n3, e6.style.background = "transparent";
-  }), await Iy("planet", { planet: e5.name, longitude: e5.longitude, sign: (t2 = e5.sign) == null ? null : t2, house: (n2 = e5.house) == null ? null : n2, retrograde: (r2 = e5.retrograde) == null ? false : r2, speed: (i2 = e5.speed) == null ? null : i2 });
+  }), await Ly("planet", { planet: e5.name, longitude: e5.longitude, sign: (t2 = e5.sign) == null ? null : t2, house: (n2 = e5.house) == null ? null : n2, retrograde: (r2 = e5.retrograde) == null ? false : r2, speed: (i2 = e5.speed) == null ? null : i2 });
 }
-async function Ry(e5) {
+async function zy(e5) {
   var t2, n2;
-  await Iy("house", { house_number: e5.number, sign: (t2 = e5.sign) == null ? null : t2, cusp_longitude: e5.cusp_lon, ruler: (n2 = e5.ruler) == null ? null : n2 });
+  await Ly("house", { house_number: e5.number, sign: (t2 = e5.sign) == null ? null : t2, cusp_longitude: e5.cusp_lon, ruler: (n2 = e5.ruler) == null ? null : n2 });
 }
-async function zy(e5) {
+async function By(e5) {
   var t2, n2, r2, i2;
-  await Iy("aspect", { planet1: e5.planet1, planet2: e5.planet2, aspect_type: (t2 = e5.type) == null ? null : t2, orb: (n2 = e5.orb) == null ? null : n2, applying: (r2 = e5.applying) == null ? null : r2, angle: (i2 = e5.angle) == null ? null : i2 });
+  await Ly("aspect", { planet1: e5.planet1, planet2: e5.planet2, aspect_type: (t2 = e5.type) == null ? null : t2, orb: (n2 = e5.orb) == null ? null : n2, applying: (r2 = e5.applying) == null ? null : r2, angle: (i2 = e5.angle) == null ? null : i2 });
 }
-function By() {
+function Vy() {
   return async (e5) => {
     try {
       var t2, n2;
@@ -7952,30 +7955,30 @@ function By() {
     }
   };
 }
-async function Vy(e5) {
+async function Hy(e5) {
   try {
     (await vy.sendMessage({ role: "user", content: [{ type: "text", text: e5 }] })).isError && console.error("[ChartWheel] Host rejected sendMessage");
   } catch (e6) {
     console.error("[ChartWheel] sendMessage failed:", e6);
   }
 }
-async function Hy() {
+async function Uy() {
   var e5, t2, n2, r2;
   if (!$) return;
   let i2 = $, a2 = (e5 = i2._birth_params) == null ? {} : e5, o2 = (t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this person" : t2, s2 = K_(i2.planets), c2 = ((r2 = i2.aspects) == null ? [] : r2).filter((e6) => {
     var t3;
     return ["conjunction", "opposition", "trine", "square", "sextile"].includes((t3 = e6.type) == null ? "" : t3);
   }).slice(0, 8).map((e6) => "  \u2022 ".concat(e6.planet1, " ").concat(e6.type, " ").concat(e6.planet2, " (").concat(Number(e6.orb).toFixed(1), "\xB0, ").concat(e6.applying ? "applying" : "separating", ")")).join("\n") || "  \u2022 No major aspects found";
-  await Vy("Please give a complete natal chart interpretation for ".concat(o2, ".\n\nKey planet placements:\n").concat(s2.slice(0, 5).map((e6) => {
+  await Hy("Please give a complete natal chart interpretation for ".concat(o2, ".\n\nKey planet placements:\n").concat(s2.slice(0, 5).map((e6) => {
     var t3;
     return "  \u2022 ".concat(e6.name, " in ").concat((t3 = e6.sign) == null ? "?" : t3).concat(e6.house ? ", House ".concat(e6.house) : "").concat(e6.retrograde ? " \u211E" : "");
   }).join("\n"), "\n\nMajor aspects:\n").concat(c2, "\n\nCover: (1) Core identity and soul purpose (Sun, Moon, Ascendant), (2) The chart's dominant element, modality, and overall signature, (3) The most significant aspects and their psychological themes, (4) Key life areas of focus and challenge, (5) A practical synthesis \u2014 who is this person and what is their path?"));
 }
-async function Uy() {
+async function Wy() {
   var e5, t2, n2, r2;
   if (!$) return;
   let i2 = $, a2 = (e5 = i2._birth_params) == null ? {} : e5;
-  await Vy("I'm exploring the natal chart for ".concat((t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this chart" : t2, ". Key placements: ").concat(K_(i2.planets).slice(0, 4).map((e6) => {
+  await Hy("I'm exploring the natal chart for ".concat((t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this chart" : t2, ". Key placements: ").concat(K_(i2.planets).slice(0, 4).map((e6) => {
     var t3;
     return "".concat(e6.name, " in ").concat((t3 = e6.sign) == null ? "?" : t3).concat(e6.house ? " H".concat(e6.house) : "");
   }).join(", ") || "unknown placements", ". Major aspects: ").concat(((r2 = i2.aspects) == null ? [] : r2).filter((e6) => {
@@ -7983,7 +7986,7 @@ async function Uy() {
     return ["conjunction", "opposition", "trine", "square", "sextile"].includes((t3 = e6.type) == null ? "" : t3);
   }).slice(0, 5).map((e6) => "".concat(e6.planet1, " ").concat(e6.type, " ").concat(e6.planet2, " (").concat(Number(e6.orb).toFixed(1), "\xB0)")).join(", ") || "none detected", ".\n\nBased on this chart, please suggest 3-4 specific, insightful questions I could ask to understand this person more deeply \u2014 such as how particular placements manifest in real life, the most significant aspect dynamics, or how to integrate the chart's core tensions. Present each as a tappable question I can ask you."));
 }
-async function Wy(e5) {
+async function Gy(e5) {
   let t2 = "";
   if (e5.type === "planet") {
     var n2;
@@ -8018,7 +8021,7 @@ async function Wy(e5) {
     throw console.error("[ChartWheel] \u274C sendMessage failed:", e6), e6;
   }
 }
-async function Gy(e5) {
+async function Ky(e5) {
   if (!($ != null && $._birth_params)) {
     Uv(py, yy);
     return;
@@ -8031,21 +8034,21 @@ async function Gy(e5) {
     console.error("[Chart] Recalculate failed:", e6), Uv(py, yy);
   }
 }
-var Ky;
-function qy() {
-  Ky && (clearTimeout(Ky), Ky = void 0);
+var qy;
+function Jy() {
+  qy && (clearTimeout(qy), qy = void 0);
 }
-function Jy(e5, t2) {
-  qy(), ly.setAttribute("hidden", ""), iy({ container: uy, message: e5, onRetry: t2 });
+function Yy(e5, t2) {
+  Jy(), ly.setAttribute("hidden", ""), iy({ container: uy, message: e5, onRetry: t2 });
 }
-function Yy() {
-  qy(), uy.setAttribute("hidden", ""), ly.removeAttribute("hidden"), Ky = setTimeout(() => {
-    Jy("The chart didn't load. Tap to try again.", Yy);
+function Xy() {
+  Jy(), uy.setAttribute("hidden", ""), ly.removeAttribute("hidden"), qy = setTimeout(() => {
+    Yy("The chart didn't load. Tap to try again.", Xy);
   }, 3e4), vy.sendMessage({ role: "user", content: [{ type: "text", text: "Please regenerate the chart wheel." }] }).catch(() => {
   });
 }
-oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }), Ky = setTimeout(() => {
-  Jy("Chart data is taking longer than expected.", Yy);
+oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }), qy = setTimeout(() => {
+  Yy("Chart data is taking longer than expected.", Xy);
 }, 3e4), (async () => {
   try {
     await vy.connect();
@@ -8054,7 +8057,7 @@ oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }),
       $ && wy($);
     }), $ && wy($);
   } catch (e5) {
-    console.error("[ChartWheel] \u274C app.connect() FAILED:", e5), Jy("The chart didn't load. Tap to try again.", Yy);
+    console.error("[ChartWheel] \u274C app.connect() FAILED:", e5), Yy("The chart didn't load. Tap to try again.", Xy);
   }
 })();
 </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "4.7.0",
+  "version": "4.8.1",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,7 @@
     "check:schema-packs": "tsx scripts/schema-packs.ts --check",
     "sync:readme": "tsx scripts/sync-readme.ts --write",
     "check:readme": "tsx scripts/sync-readme.ts --check",
+    "check:counts": "tsx scripts/check-counts.ts",
     "check:pack": "tsx scripts/pack-audit.ts",
     "regen:plugin": "tsx scripts/plugin-audit.ts --write",
     "check:plugin": "tsx scripts/plugin-audit.ts --check",
@@ -48,7 +49,8 @@
     "check:skills": "node scripts/build-skills.mjs --check",
     "sync:public": "node scripts/sync-public-repo.mjs --write",
     "check:public": "node scripts/sync-public-repo.mjs --check",
-    "verify:release": "npm run check:dev-allowlist && npm run check:schema-packs && npm run check:readme && npm run check:skills && npm run check:plugin && npm run check:public && npm run typecheck && npm test && npm run build && npm run check:pack",
+    "check:public:strict": "node scripts/sync-public-repo.mjs --check --require-mirror",
+    "verify:release": "npm run check:dev-allowlist && npm run check:schema-packs && npm run check:readme && npm run check:counts && npm run check:skills && npm run check:plugin && npm run check:public:strict && npm run typecheck && npm test && npm run build && npm run check:pack",
     "prepack": "npm run build",
     "prepublishOnly": "npm run verify:release",
     "capture:fixtures": "tsx scripts/capture-harness-fixtures.ts"

package/smithery.yaml

@@ -7,12 +7,12 @@
 
 name: Open Ephemeris
 description: >
-  NASA JPL DE440-backed astronomical computation engine for AI agents. 90+ typed tools covering
+  NASA JPL DE440-backed astronomical computation engine for AI agents. Typed tools spanning
   natal charts, transit forecasting, Human Design charts, eclipses, astrocartography power
   lines, Venus Star Points, electional timing windows, synastry, composite charts, Vedic
   charts, Chinese BaZi, and more — powered by JPL DE440 ephemerides for sub-arcsecond
   zero-hallucination accuracy. Includes an LLM-optimized output format
-  (format=llm) that compresses chart responses by ~50%. Free Explorer tier available.
+  (format=llm) that compresses chart responses by 50–73%. Free Explorer tier available.
 iconUrl: https://mcp.openephemeris.com/icon.png
 homepage: https://openephemeris.com
 
@@ -38,7 +38,7 @@ configSchema:
         - llm
       description: >
         Default output format for all tools. 'llm' returns compact,
-        token-optimized output (~50% smaller). 'json' returns full verbose JSON.
+        token-optimized output (50–73% smaller). 'json' returns full verbose JSON.
         Individual tool calls can override this setting.
       default: json
     baseUrl:
@@ -49,6 +49,16 @@ configSchema:
         default production endpoint (https://api.openephemeris.com). Useful
         for self-hosted or staging deployments.
       default: ""
+    toolSurface:
+      type: string
+      title: Tool Surface
+      description: >
+        Which tools to advertise. Leave blank for the curated default set,
+        'full' for the whole catalog, or a comma list of traditions —
+        astrology, moon, hd, bazi, vedic, acg, electional, venus — to pay
+        context only for the work you do (e.g. 'hd,bazi'). Every tool stays
+        callable by name regardless of surface.
+      default: ""
 
 # How to start the server locally (stdio transport for Claude Desktop / Cursor)
 startCommand:
@@ -61,5 +71,6 @@ startCommand:
         OPENEPHEMERIS_API_KEY: config.apiKey,
         ...(config.format && config.format !== "json" ? { OPENEPHEMERIS_FORMAT: config.format } : {}),
         ...(config.baseUrl ? { OPENEPHEMERIS_BACKEND_URL: config.baseUrl } : {}),
+        ...(config.toolSurface ? { OPENEPHEMERIS_TOOLS: config.toolSurface } : {}),
       }
     })