@openephemeris/mcp-server 3.10.4 → 3.13.0

package/README.md

@@ -353,10 +353,10 @@ When you update the MCP server logic (handlers, bug fixes, hardening), you shoul
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **23**
-- Methods: `GET=4`, `POST=19`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **57**
-- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_natal_chart`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
+- Allowlisted operations: **28**
+- Methods: `GET=4`, `POST=24`, `PUT=0`, `PATCH=0`, `DELETE=0`
+- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **64**
+- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `bi_wheel_on_cross_aspect_click`, `bi_wheel_on_planet_click`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_bi_wheel`, `explore_human_design`, `explore_natal_chart`, `hd_on_center_click`, `hd_on_channel_click`, `hd_on_gate_click`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
 - Generic tools: 
 
 ### Allowlist Families
@@ -364,6 +364,7 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 | Family | Operations | Example |
 |---|---:|---|
 | `acg` | 4 | `POST /acg/ccg`, `POST /acg/hits` |
+| `chinese` | 5 | `POST /chinese/bazi/compatibility`, `POST /chinese/bazi/element-balance` |
 | `comparative` | 5 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
 | `electional` | 4 | `GET /electional/aspect-search`, `GET /electional/find-window` |
 | `ephemeris` | 1 | `POST /ephemeris/relocation` |

package/config/dev-allowlist.json

@@ -31,6 +31,26 @@
       "method": "POST",
       "path": "/acg/power-lines"
     },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/compatibility"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/element-balance"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/luck-pillars"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/solar-terms"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/ten-gods"
+    },
     {
       "method": "POST",
       "path": "/comparative/composite/midpoint"
@@ -108,8 +128,8 @@
       "path": "/visualization/chart-wheel"
     }
   ],
-  "last_generated_at": "2026-04-22T15:19:21.508Z",
-  "openapi_sha256": "0c29ad2e37fd08d48800ec54059e262fbbdb681b844e00fed9274611bae678ac",
+  "last_generated_at": "2026-04-25T17:47:00.681Z",
+  "openapi_sha256": "9b2a79811fef658557233fc649b598178488985708b3ad10f252be598567080a",
   "candidates_get": [
     {
       "method": "GET",
@@ -391,6 +411,14 @@
       ],
       "operationId": "reverse_geocode_location_reverse_get"
     },
+    {
+      "method": "GET",
+      "path": "/tidal/forcing/deep-time",
+      "tags": [
+        "tidal"
+      ],
+      "operationId": "get_tidal_forcing_deep_time_endpoint_tidal_forcing_deep_time_get"
+    },
     {
       "method": "GET",
       "path": "/tidal/forcing",
@@ -521,6 +549,54 @@
       ],
       "operationId": "power_lines_acg_power_lines_post"
     },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/annual-pillar",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_annual_pillar_chinese_bazi_annual_pillar_post"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/compatibility",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_compatibility_chinese_bazi_compatibility_post"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/element-balance",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_element_balance_chinese_bazi_element_balance_post"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/luck-pillars",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_luck_pillars_chinese_bazi_luck_pillars_post"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/solar-terms",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_solar_terms_chinese_bazi_solar_terms_post"
+    },
+    {
+      "method": "POST",
+      "path": "/chinese/bazi/ten-gods",
+      "tags": [
+        "chinese"
+      ],
+      "operationId": "bazi_ten_gods_chinese_bazi_ten_gods_post"
+    },
     {
       "method": "POST",
       "path": "/chinese/bazi",
@@ -994,6 +1070,11 @@
       "Non-GET allowlisted: POST /acg/hits",
       "Non-GET allowlisted: POST /acg/local-space",
       "Non-GET allowlisted: POST /acg/power-lines",
+      "Non-GET allowlisted: POST /chinese/bazi/compatibility",
+      "Non-GET allowlisted: POST /chinese/bazi/element-balance",
+      "Non-GET allowlisted: POST /chinese/bazi/luck-pillars",
+      "Non-GET allowlisted: POST /chinese/bazi/solar-terms",
+      "Non-GET allowlisted: POST /chinese/bazi/ten-gods",
       "Non-GET allowlisted: POST /comparative/composite/midpoint",
       "Non-GET allowlisted: POST /comparative/composite",
       "Non-GET allowlisted: POST /comparative/natal-transits",

package/dist/index.js

@@ -5,8 +5,10 @@ import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
+import { initTools, toolRegistry, formatToolResponse, modelVisibleTools } from "./tools/index.js";
 import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
+import { BODYGRAPH_RESOURCE_URI, BODYGRAPH_MIME_TYPE, getBodygraphBundle, } from "./tools/apps/bodygraph-app.js";
+import { BI_WHEEL_RESOURCE_URI, BI_WHEEL_MIME_TYPE, getBiWheelBundle, } from "./tools/apps/bi-wheel-app.js";
 function resolveServerVersion() {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -41,7 +43,7 @@ const server = new Server({
 // List available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
-        tools: Object.values(toolRegistry).map((tool) => ({
+        tools: modelVisibleTools().map((tool) => ({
             name: tool.name,
             description: tool.description,
             inputSchema: tool.inputSchema,
@@ -96,38 +98,55 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 });
 // List available resources
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    const bundle = getChartWheelBundle();
-    if (!bundle)
-        return { resources: [] };
-    return {
-        resources: [
-            {
-                uri: CHART_WHEEL_RESOURCE_URI,
-                name: "Chart Wheel Explorer",
-                description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
-                mimeType: CHART_WHEEL_MIME_TYPE,
-            },
-        ],
-    };
+    const resources = [];
+    if (getChartWheelBundle()) {
+        resources.push({
+            uri: CHART_WHEEL_RESOURCE_URI,
+            name: "Chart Wheel Explorer",
+            description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+            mimeType: CHART_WHEEL_MIME_TYPE,
+        });
+    }
+    if (getBodygraphBundle()) {
+        resources.push({
+            uri: BODYGRAPH_RESOURCE_URI,
+            name: "Human Design Bodygraph Explorer",
+            description: "Interactive Human Design Bodygraph with clickable centers, gates, and channels.",
+            mimeType: BODYGRAPH_MIME_TYPE,
+        });
+    }
+    if (getBiWheelBundle()) {
+        resources.push({
+            uri: BI_WHEEL_RESOURCE_URI,
+            name: "Bi-Wheel Explorer",
+            description: "Interactive synastry or transit bi-wheel with cross-aspect lines and clickable planets.",
+            mimeType: BI_WHEEL_MIME_TYPE,
+        });
+    }
+    return { resources };
 });
 // Read resource
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
-        throw new Error(`Unknown resource: ${request.params.uri}`);
+    const uri = request.params.uri;
+    if (uri === CHART_WHEEL_RESOURCE_URI) {
+        const bundle = getChartWheelBundle();
+        if (!bundle)
+            throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: CHART_WHEEL_RESOURCE_URI, mimeType: CHART_WHEEL_MIME_TYPE, text: bundle }] };
     }
-    const bundle = getChartWheelBundle();
-    if (!bundle) {
-        throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+    if (uri === BODYGRAPH_RESOURCE_URI) {
+        const bundle = getBodygraphBundle();
+        if (!bundle)
+            throw new Error("Bodygraph UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: BODYGRAPH_RESOURCE_URI, mimeType: BODYGRAPH_MIME_TYPE, text: bundle }] };
     }
-    return {
-        contents: [
-            {
-                uri: CHART_WHEEL_RESOURCE_URI,
-                mimeType: CHART_WHEEL_MIME_TYPE,
-                text: bundle,
-            },
-        ],
-    };
+    if (uri === BI_WHEEL_RESOURCE_URI) {
+        const bundle = getBiWheelBundle();
+        if (!bundle)
+            throw new Error("Bi-Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: BI_WHEEL_RESOURCE_URI, mimeType: BI_WHEEL_MIME_TYPE, text: bundle }] };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
 });
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {

package/dist/server-sse.js

@@ -22,9 +22,11 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
-import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
+import { initTools, toolRegistry, formatToolResponse, modelVisibleTools } from "./tools/index.js";
 import { BackendClient, runWithClient } from "./backend/client.js";
 import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
+import { BODYGRAPH_RESOURCE_URI, BODYGRAPH_MIME_TYPE, getBodygraphBundle, } from "./tools/apps/bodygraph-app.js";
+import { BI_WHEEL_RESOURCE_URI, BI_WHEEL_MIME_TYPE, getBiWheelBundle, } from "./tools/apps/bi-wheel-app.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -193,7 +195,7 @@ function createMcpServer() {
     });
     // --- Tool handlers ---
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: Object.values(toolRegistry).map((tool) => ({
+        tools: modelVisibleTools().map((tool) => ({
             name: tool.name,
             description: tool.description,
             inputSchema: tool.inputSchema,
@@ -243,37 +245,54 @@ function createMcpServer() {
     });
     // --- Resource handlers ---
     server.setRequestHandler(ListResourcesRequestSchema, async () => {
-        const bundle = getChartWheelBundle();
-        if (!bundle)
-            return { resources: [] };
-        return {
-            resources: [
-                {
-                    uri: CHART_WHEEL_RESOURCE_URI,
-                    name: "Chart Wheel Explorer",
-                    description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
-                    mimeType: CHART_WHEEL_MIME_TYPE,
-                },
-            ],
-        };
+        const resources = [];
+        if (getChartWheelBundle()) {
+            resources.push({
+                uri: CHART_WHEEL_RESOURCE_URI,
+                name: "Chart Wheel Explorer",
+                description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+                mimeType: CHART_WHEEL_MIME_TYPE,
+            });
+        }
+        if (getBodygraphBundle()) {
+            resources.push({
+                uri: BODYGRAPH_RESOURCE_URI,
+                name: "Human Design Bodygraph Explorer",
+                description: "Interactive Human Design Bodygraph with clickable centers, gates, and channels.",
+                mimeType: BODYGRAPH_MIME_TYPE,
+            });
+        }
+        if (getBiWheelBundle()) {
+            resources.push({
+                uri: BI_WHEEL_RESOURCE_URI,
+                name: "Bi-Wheel Explorer",
+                description: "Interactive synastry or transit bi-wheel with cross-aspect lines and clickable planets.",
+                mimeType: BI_WHEEL_MIME_TYPE,
+            });
+        }
+        return { resources };
     });
     server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-        if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
-            throw new Error(`Unknown resource: ${request.params.uri}`);
+        const uri = request.params.uri;
+        if (uri === CHART_WHEEL_RESOURCE_URI) {
+            const bundle = getChartWheelBundle();
+            if (!bundle)
+                throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: CHART_WHEEL_RESOURCE_URI, mimeType: CHART_WHEEL_MIME_TYPE, text: bundle }] };
         }
-        const bundle = getChartWheelBundle();
-        if (!bundle) {
-            throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        if (uri === BODYGRAPH_RESOURCE_URI) {
+            const bundle = getBodygraphBundle();
+            if (!bundle)
+                throw new Error("Bodygraph UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: BODYGRAPH_RESOURCE_URI, mimeType: BODYGRAPH_MIME_TYPE, text: bundle }] };
         }
-        return {
-            contents: [
-                {
-                    uri: CHART_WHEEL_RESOURCE_URI,
-                    mimeType: CHART_WHEEL_MIME_TYPE,
-                    text: bundle,
-                },
-            ],
-        };
+        if (uri === BI_WHEEL_RESOURCE_URI) {
+            const bundle = getBiWheelBundle();
+            if (!bundle)
+                throw new Error("Bi-Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: BI_WHEEL_RESOURCE_URI, mimeType: BI_WHEEL_MIME_TYPE, text: bundle }] };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
     });
     return server;
 }
@@ -315,7 +334,7 @@ async function main() {
     // Spec: https://smithery.ai/docs/build/publish#server-scanning
     // ---------------------------------------------------------------------------
     app.get("/.well-known/mcp/server-card.json", (_req, res) => {
-        const tools = Object.values(toolRegistry).map((tool) => ({
+        const tools = modelVisibleTools().map((tool) => ({
             name: tool.name,
             description: tool.description,
             inputSchema: tool.inputSchema,

package/dist/tools/apps/bi-wheel-app.d.ts

@@ -0,0 +1,38 @@
+/**
+ * bi-wheel-app.ts — MCP App tool registration for the Bi-Wheel Explorer.
+ *
+ * Registers 3 tools:
+ *   • explore_bi_wheel               — primary entry point: fetches two charts, computes
+ *                                      cross-aspects, returns data + UI resource [model]
+ *   • bi_wheel_on_cross_aspect_click — cross-aspect click handler [app-only]
+ *   • bi_wheel_on_planet_click       — planet click handler (inner or outer wheel) [app-only]
+ *
+ * Modes:
+ *   synastry — fetch two natal charts in parallel (person1 inner, person2 outer)
+ *   transit  — fetch one natal chart (inner) + one transit chart (outer)
+ *
+ * Cross-aspects are computed client-side (UI) AND server-side (for summary/fallback).
+ * The payload cross_aspects array is capped at 30 tightest-orb aspects.
+ */
+export declare const BI_WHEEL_RESOURCE_URI = "ui://openephemeris/bi-wheel";
+export declare const BI_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getBiWheelBundle(): string | null;
+export declare function clearBiWheelBundleCache(): void;
+interface PlanetPoint {
+    name: string;
+    longitude: number;
+    speed?: number;
+}
+interface CrossAspect {
+    planet1: string;
+    wheel1: "inner" | "outer";
+    planet2: string;
+    wheel2: "inner" | "outer";
+    type: string;
+    angle: number;
+    orb: number;
+    applying: boolean;
+}
+export declare function computeCrossAspects(planets1: PlanetPoint[], planets2: PlanetPoint[]): CrossAspect[];
+export {};