@openephemeris/mcp-server 3.13.10 → 3.15.0

package/dist/tools/output-schemas.js

@@ -0,0 +1,130 @@
+/**
+ * output-schemas.ts — Shared JSON Schema output schema definitions for MCP tools.
+ *
+ * MCP spec 2025-11-25 supports `outputSchema` on tool definitions. Smithery
+ * uses this field to score the "Output schemas" quality criterion (10.37pt / 57 tools).
+ *
+ * All tools return an MCP content block response. Most return a single JSON text
+ * block; visual tools return an image block or an image + text block.
+ *
+ * Usage:
+ *   import { OUTPUT_SCHEMA_JSON, OUTPUT_SCHEMA_IMAGE } from "../output-schemas.js";
+ *   registerTool({ ..., outputSchema: OUTPUT_SCHEMA_JSON });
+ */
+// ── Base MCP content block shapes ─────────────────────────────────────────────
+/** JSON Schema for a single MCP text content block */
+const TEXT_CONTENT_BLOCK = {
+    type: "object",
+    properties: {
+        type: { type: "string", const: "text" },
+        text: { type: "string" },
+    },
+    required: ["type", "text"],
+    additionalProperties: false,
+};
+/** JSON Schema for a single MCP image content block */
+const IMAGE_CONTENT_BLOCK = {
+    type: "object",
+    properties: {
+        type: { type: "string", const: "image" },
+        data: { type: "string", description: "Base64-encoded image data" },
+        mimeType: { type: "string", enum: ["image/svg+xml", "image/png", "image/jpeg"] },
+    },
+    required: ["type", "data", "mimeType"],
+    additionalProperties: false,
+};
+// ── Exported output schemas ────────────────────────────────────────────────────
+/**
+ * Standard tool output schema: a single JSON text block.
+ * Used by all data-returning tools (natal chart, transits, synastry, etc.).
+ */
+export const OUTPUT_SCHEMA_JSON = {
+    type: "object",
+    properties: {
+        content: {
+            type: "array",
+            items: { oneOf: [TEXT_CONTENT_BLOCK] },
+            minItems: 1,
+        },
+        isError: { type: "boolean" },
+    },
+    required: ["content"],
+};
+/**
+ * Visual tool output schema: a single SVG or PNG image block.
+ * Used by chart wheel (direct image), BaZi chart, Vedic chart, etc.
+ */
+export const OUTPUT_SCHEMA_IMAGE = {
+    type: "object",
+    properties: {
+        content: {
+            type: "array",
+            items: { oneOf: [IMAGE_CONTENT_BLOCK] },
+            minItems: 1,
+        },
+        isError: { type: "boolean" },
+    },
+    required: ["content"],
+};
+/**
+ * Dual output schema: an image block followed by a JSON text block.
+ * Used by tools with include_visual=true (natal chart SVG + data, bi-wheel, etc.).
+ */
+export const OUTPUT_SCHEMA_IMAGE_AND_JSON = {
+    type: "object",
+    properties: {
+        content: {
+            type: "array",
+            items: { oneOf: [TEXT_CONTENT_BLOCK, IMAGE_CONTENT_BLOCK] },
+            minItems: 1,
+        },
+        isError: { type: "boolean" },
+    },
+    required: ["content"],
+};
+/**
+ * Interactive app tool output schema: a text block containing MCP App metadata.
+ * Used by explore_* tools that return an embedded UI resource reference.
+ */
+export const OUTPUT_SCHEMA_APP = {
+    type: "object",
+    properties: {
+        content: {
+            type: "array",
+            items: { oneOf: [TEXT_CONTENT_BLOCK] },
+            minItems: 1,
+        },
+        _meta: {
+            type: "object",
+            description: "MCP Apps UI linkage metadata",
+            properties: {
+                "ui/resourceUri": { type: "string" },
+                ui: {
+                    type: "object",
+                    properties: {
+                        resourceUri: { type: "string" },
+                        visibility: { type: "array", items: { type: "string" } },
+                    },
+                },
+            },
+        },
+        isError: { type: "boolean" },
+    },
+    required: ["content"],
+};
+/**
+ * Auth tool output schema: a JSON text block confirming auth status or credentials.
+ */
+export const OUTPUT_SCHEMA_AUTH = {
+    type: "object",
+    properties: {
+        content: {
+            type: "array",
+            items: { oneOf: [TEXT_CONTENT_BLOCK] },
+            minItems: 1,
+            maxItems: 1,
+        },
+        isError: { type: "boolean" },
+    },
+    required: ["content"],
+};

package/dist/tools/specialized/acg.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";
 const ACG_BODY_DESCRIPTION = "List of celestial bodies for line calculation. " +
     "E.g. ['Sun', 'Moon', 'Venus', 'Mars', 'Jupiter', 'Saturn']. " +
     "Aliases: 'NorthNode'/'Node'/'Rahu' → MeanNode, 'SouthNode'/'Ketu' → SouthNode. " +
@@ -54,6 +55,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Astrocartography Lines", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude"]);
@@ -147,6 +149,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Astrocartography Location Hits", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"]);

package/dist/tools/specialized/bazi.js

@@ -1,5 +1,6 @@
 import { registerTool } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 function parseBaziArgs(args) {
     let { year, month, day, hour } = args;
     if (args.datetime && (!year || !month || !day)) {
@@ -106,6 +107,7 @@ registerTool({
         },
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "BaZi Four Pillars Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const body = { ...parseBaziArgs(args) };
@@ -142,7 +144,8 @@ registerTool({
         },
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Day Master Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const body = { ...parseBaziArgs(args) };
         applyVisualConfig(body, args);
@@ -176,7 +179,8 @@ registerTool({
         },
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Clash & Combination", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Element Balance", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const body = { ...parseBaziArgs(args) };
         applyVisualConfig(body, args);
@@ -218,7 +222,8 @@ registerTool({
         required: ["gender"],
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         if (!args.gender) {
             throw new Error("gender is required for luck pillar calculation. " +
@@ -260,7 +265,8 @@ registerTool({
         required: ["year"],
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Annual Pillar", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         if (!args.year) {
             throw new Error("year is required. Provide a Gregorian year (1–9999), e.g. year=2025.");
@@ -314,7 +320,8 @@ registerTool({
         },
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Annual Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const chartAComponents = parseBaziArgs({
             year: args.chart_a_year,
@@ -373,7 +380,8 @@ registerTool({
         },
         additionalProperties: false,
     },
-    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "BaZi Chart (Visual)", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const { year, month, day, hour } = parseBaziArgs(args);
         const body = {

package/dist/tools/specialized/bi_wheel.js

@@ -1,5 +1,6 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE } from "../output-schemas.js";
 const DATETIME_DESC = "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). " +
     "Include timezone offset if known, e.g. '1990-04-15T14:30:00-05:00'.";
 const HOUSE_SYSTEM_MAP = {
@@ -38,6 +39,7 @@ registerTool({
         required: ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE,
     annotations: { title: "Bi-Wheel Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"]);
@@ -69,7 +71,8 @@ registerTool({
             const mappedCode = HOUSE_SYSTEM_MAP[args.house_system] || "P";
             body.configuration = { house_system: mappedCode };
         }
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/bi-wheel?format=svg&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/chart_wheel.js

@@ -1,5 +1,6 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE } from "../output-schemas.js";
 const DATETIME_DESC = "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). " +
     "Include timezone offset if known, e.g. '1990-04-15T14:30:00-05:00'.";
 const HOUSE_SYSTEM_MAP = {
@@ -46,6 +47,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE,
     annotations: { title: "Chart Wheel SVG", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
@@ -66,7 +68,8 @@ registerTool({
             const mappedCode = HOUSE_SYSTEM_MAP[args.house_system] || "P";
             body.configuration = { house_system: mappedCode };
         }
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/chart-wheel?format=svg&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/comparative.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";
 function buildSubject(name, datetime, lat, lon, timezone) {
     const subj = {
         name,
@@ -42,6 +43,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Davison Relationship Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
@@ -87,6 +89,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Midpoint Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
@@ -132,7 +135,8 @@ registerTool({
         ],
         additionalProperties: false,
     },
-    annotations: { title: "Planet Compatibility Score", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Synastry House Overlay", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -174,7 +178,8 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude"],
         additionalProperties: false,
     },
-    annotations: { title: "Composite Chart Aspects", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Transits to Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude"]);
         // Backend expects: { subject: {...}, transit_datetime?: {...} }

package/dist/tools/specialized/eclipse.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired, validateCoordinates } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_next_eclipse",
     description: "Find the next solar or lunar eclipse. " +
@@ -40,6 +41,7 @@ registerTool({
         required: ["eclipse_type"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Eclipse Finder", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["eclipse_type"]);

package/dist/tools/specialized/electional.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";
 // All electional endpoints are GET endpoints with query params.
 // GET /electional/find-window — already existed, keeping it
 registerTool({
@@ -56,6 +57,7 @@ registerTool({
         required: ["start_date", "end_date", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Electional Timing Window", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date", "latitude", "longitude"]);
@@ -106,6 +108,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Moment Quality Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
@@ -157,6 +160,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Retrograde Station Tracker", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
@@ -216,6 +220,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Active Aspects Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};

package/dist/tools/specialized/ephemeris_core.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";
 // POST /ephemeris/planet-position — OE-016
 registerTool({
     name: "ephemeris_planet_position",
@@ -34,6 +35,7 @@ registerTool({
         required: ["planet_id", "datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Planet Position", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet_id", "datetime"]);
@@ -81,6 +83,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "House Cusps", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);

package/dist/tools/specialized/ephemeris_extended.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";
 function buildSubject(name, datetime, lat, lon) {
     return {
         name,
@@ -42,6 +43,7 @@ registerTool({
         required: ["subjects"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Natal Batch Charts", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["subjects"]);
@@ -65,6 +67,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Essential Dignities", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
@@ -92,6 +95,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Retrograde Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
@@ -141,6 +145,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Midpoints", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
@@ -171,6 +176,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Fixed Stars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
@@ -231,6 +237,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Hermetic Lots", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
@@ -257,6 +264,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Angles & Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
@@ -285,6 +293,7 @@ registerTool({
         required: ["longitude_1", "longitude_2"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Aspect Check", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["longitude_1", "longitude_2"]);

package/dist/tools/specialized/hd_bodygraph.js

@@ -1,5 +1,6 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 /** Append 'Z' if no timezone offset is present in the datetime string. */
 function ensureTimezone(dt) {
     if (/[Zz]$/.test(dt) || /[+-]\d{2}:\d{2}$/.test(dt))
@@ -39,14 +40,16 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Human Design Bodygraph", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {
             birth_datetime_utc: ensureTimezone(args.datetime),
         };
-        const format = args.format || "svg";
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const format = pickEnum(args.format, ["svg", "png"]) || "svg";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/bodygraph?format=${format}&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/hd_cycles.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";
 /**
  * Ensure a datetime string has a timezone offset for Go's time.Time parsing.
  */
@@ -49,6 +50,7 @@ registerTool({
         required: ["planet", "datetime", "return_year"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "HD Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "return_year"]);
@@ -100,6 +102,7 @@ registerTool({
         required: ["planet", "datetime", "target_year"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "HD Opposition Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "target_year"]);

package/dist/tools/specialized/hd_group.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";
 // POST /human-design/composite — OE-027
 registerTool({
     name: "human_design_composite",
@@ -28,6 +29,7 @@ registerTool({
         required: ["person_a_datetime", "person_b_datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["person_a_datetime", "person_b_datetime"]);
@@ -88,6 +90,7 @@ registerTool({
         required: ["group_name", "members"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "HD Penta Group Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["group_name", "members"]);

package/dist/tools/specialized/human_design.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 /**
  * Ensure a datetime string has a timezone offset for Go's time.Time parsing.
  * Go's encoding/json only accepts RFC 3339 (must have Z or +HH:MM offset).
@@ -64,6 +65,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);

package/dist/tools/specialized/moon.js

@@ -1,5 +1,6 @@
 import { registerTool, validateCoordinates } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_moon_phase",
     description: "Get the Moon's current phase angle, illumination, and void-of-course status AT a specific " +
@@ -33,6 +34,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateCoordinates(args, "latitude", "longitude");
@@ -91,6 +93,7 @@ registerTool({
         required: ["phase"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Next Lunar Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         // Map our clean enum to display names the calendar API returns

package/dist/tools/specialized/natal.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 const DATETIME_DESC = "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). " +
     "Include timezone offset if known, e.g. '1990-04-15T14:30:00-05:00'.";
 /** Map human-readable house system names to standard single-letter codes */
@@ -73,6 +74,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);

package/dist/tools/specialized/progressed.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_progressed_chart",
     description: "Calculate a Secondary Progressed (or Solar Arc / Tertiary) chart. " +
@@ -56,6 +57,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Progressed Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"]);

package/dist/tools/specialized/relocation.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";
 registerTool({
     name: "ephemeris_relocation",
     description: "Calculate a relocation chart — the same natal planetary positions re-cast for a different " +
@@ -46,6 +47,7 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_JSON,
     annotations: { title: "Relocation Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"]);

package/dist/tools/specialized/returns.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 // POST /predictive/returns/solar
 registerTool({
     name: "ephemeris_solar_return",
@@ -59,6 +60,7 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Solar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
@@ -127,6 +129,7 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Lunar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
@@ -182,6 +185,7 @@ registerTool({
         required: ["body", "birth_datetime", "target_datetime"],
         additionalProperties: false,
     },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
     annotations: { title: "Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["body", "birth_datetime", "target_datetime"]);