@openephemeris/mcp-server 3.9.3 → 3.10.2

package/dist/tools/specialized/human_design.js

@@ -45,6 +45,21 @@ registerTool({
                 description: "Output format. 'llm' returns compact array projection for token efficiency (available on all tiers). " +
                     "'json' returns verbose full output.",
             },
+            include_visual: {
+                type: "boolean",
+                description: "When true, renders the Human Design bodygraph as an SVG and embeds it in the response. " +
+                    "The bodygraph image will display in the conversation alongside the data. " +
+                    "Costs 2 additional credits on top of the base call cost.",
+            },
+            visual_config: {
+                type: "object",
+                description: "Optional rendering preferences (only used when include_visual=true).",
+                properties: {
+                    theme: { type: "string", enum: ["light", "dark"], description: "Color theme. Default: dark (HD convention)." },
+                    size: { type: "number", description: "Canvas size in pixels, 200–4000. Default: 800." },
+                },
+                additionalProperties: false,
+            },
         },
         required: ["datetime"],
         additionalProperties: false,
@@ -61,6 +76,14 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
+        if (args.include_visual) {
+            body.include_visual = true;
+            body.visual_config = {
+                format: "svg",
+                theme: args.visual_config?.theme || "dark", // HD convention defaults to dark
+                size: args.visual_config?.size || 800,
+            };
+        }
         return await getActiveClient().request("POST", "/human-design/chart", {
             data: body,
             params: query,

package/dist/tools/specialized/natal.js

@@ -54,6 +54,21 @@ registerTool({
                 type: "boolean",
                 description: "Reserved for future use. Fixed star positions are currently available via the dedicated /ephemeris/fixed-stars endpoint.",
             },
+            include_visual: {
+                type: "boolean",
+                description: "When true, renders the natal chart wheel as an SVG and embeds it directly in the response. " +
+                    "The chart image will display in the conversation alongside the data. " +
+                    "Costs 2 additional credits on top of the base call cost.",
+            },
+            visual_config: {
+                type: "object",
+                description: "Optional rendering preferences (only used when include_visual=true).",
+                properties: {
+                    theme: { type: "string", enum: ["light", "dark"], description: "Color theme. Default: light." },
+                    size: { type: "number", description: "Canvas size in pixels, 200–4000. Default: 800." },
+                },
+                additionalProperties: false,
+            },
         },
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
@@ -91,6 +106,14 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
+        if (args.include_visual) {
+            body.include_visual = true;
+            body.visual_config = {
+                format: "svg", // always SVG for MCP — no resvg dependency
+                theme: args.visual_config?.theme || "light",
+                size: args.visual_config?.size || 800,
+            };
+        }
         return await getActiveClient().request("POST", "/ephemeris/natal-chart", {
             data: body,
             params: query,

package/dist/tools/specialized/progressed.js

@@ -37,6 +37,21 @@ registerTool({
                 type: "boolean",
                 description: "Whether to include aspect grid in the response. Default false.",
             },
+            include_visual: {
+                type: "boolean",
+                description: "When true, renders the progressed chart wheel as an SVG and embeds it in the response. " +
+                    "The chart image will display in the conversation alongside the data. " +
+                    "Costs 2 additional credits on top of the base call cost.",
+            },
+            visual_config: {
+                type: "object",
+                description: "Optional rendering preferences (only used when include_visual=true).",
+                properties: {
+                    theme: { type: "string", enum: ["light", "dark"], description: "Color theme. Default: light." },
+                    size: { type: "number", description: "Canvas size in pixels, 200–4000. Default: 800." },
+                },
+                additionalProperties: false,
+            },
         },
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"],
         additionalProperties: false,
@@ -60,6 +75,14 @@ registerTool({
         if (args.include_aspects != null) {
             body.options = { include_aspects: args.include_aspects };
         }
+        if (args.include_visual) {
+            body.include_visual = true;
+            body.visual_config = {
+                format: "svg",
+                theme: args.visual_config?.theme || "light",
+                size: args.visual_config?.size || 800,
+            };
+        }
         return await getActiveClient().post("/ephemeris/progressed", body);
     },
 });

package/dist/tools/specialized/returns.js

@@ -40,6 +40,21 @@ registerTool({
                 type: "number",
                 description: "Location longitude for the return chart (optional).",
             },
+            include_visual: {
+                type: "boolean",
+                description: "When true, renders the solar return chart wheel as an SVG and embeds it in the response. " +
+                    "The chart image will display in the conversation alongside the data. " +
+                    "Costs 2 additional credits on top of the base call cost.",
+            },
+            visual_config: {
+                type: "object",
+                description: "Optional rendering preferences (only used when include_visual=true).",
+                properties: {
+                    theme: { type: "string", enum: ["light", "dark"], description: "Color theme. Default: light." },
+                    size: { type: "number", description: "Canvas size in pixels, 200–4000. Default: 800." },
+                },
+                additionalProperties: false,
+            },
         },
         required: ["birth_datetime"],
         additionalProperties: false,
@@ -64,6 +79,14 @@ registerTool({
                 longitude: { decimal: args.return_longitude },
             };
         }
+        if (args.include_visual) {
+            body.include_visual = true;
+            body.visual_config = {
+                format: "svg",
+                theme: args.visual_config?.theme || "light",
+                size: args.visual_config?.size || 800,
+            };
+        }
         return await getActiveClient().post("/predictive/returns/solar", body);
     },
 });

package/dist/tools/specialized/synastry.js

@@ -28,6 +28,21 @@ registerTool({
                 enum: ["json", "llm"],
                 description: "Output format. 'llm' is compact and token-efficient (available on all tiers).",
             },
+            include_visual: {
+                type: "boolean",
+                description: "When true, renders a bi-wheel SVG comparing both charts and embeds it in the response. " +
+                    "The chart image will display in the conversation alongside the data. " +
+                    "Costs 2 additional credits on top of the base call cost.",
+            },
+            visual_config: {
+                type: "object",
+                description: "Optional rendering preferences (only used when include_visual=true).",
+                properties: {
+                    theme: { type: "string", enum: ["light", "dark"], description: "Color theme. Default: light." },
+                    size: { type: "number", description: "Canvas size in pixels, 200–4000. Default: 800." },
+                },
+                additionalProperties: false,
+            },
         },
         required: [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -63,6 +78,14 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
+        if (args.include_visual) {
+            body.include_visual = true;
+            body.visual_config = {
+                format: "svg",
+                theme: args.visual_config?.theme || "light",
+                size: args.visual_config?.size || 800,
+            };
+        }
         return await getActiveClient().request("POST", "/comparative/synastry", {
             data: body,
             params: query,