@openephemeris/mcp-server 3.5.1 → 3.5.3

package/CHANGELOG.md

@@ -7,6 +7,28 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [3.5.3] — 2026-04-10
+
+### Fixed
+- `ephemeris_chart_wheel` and `ephemeris_bi_wheel` tools now correctly advertise the
+  `style` values accepted by the backend (`light`, `dark`, `mono`). The previous enum
+  (`modern`, `classic`, `dark`) caused every non-dark chart request to fail with `400`.
+- SSE sessions are now fully isolated: each connection creates its own `BackendClient`
+  instance keyed to the connecting user's API key. Concurrent sessions no longer
+  overwrite each other's API key on the shared singleton, preventing cross-user
+  billing attribution errors.
+
+---
+
+## [3.5.1] — 2026-03-31
+
+### Changed
+- Added `mcp-server`, `modelcontextprotocol`, `model-context-protocol` to package.json keywords for registry discovery
+- Fixed `OE_API_KEY` → `OPENEPHEMERIS_API_KEY` in registry submission guide
+- Corrected GitHub links from `MeridianMap` to `Spirit-River` org
+
+---
+
 ## [3.5.0] — 2026-03-28
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # OpenEphemeris MCP Server
 
-[![System Status](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fblacksmithops%2Fbetter-stack-shields%2Fmain%2Fbetterstack.json&label=Status&color=success)](https://status.openephemeris.com/)
+[![System Status](https://img.shields.io/badge/Status-Operational-brightgreen)](https://status.openephemeris.com/)
 
 Model Context Protocol server for OpenEphemeris. This package exposes typed astrology tools and an allowlist-gated generic proxy (`dev.call`) for MCP-compatible clients.
 
@@ -224,8 +224,8 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **20**
-- Methods: `GET=4`, `POST=16`, `PUT=0`, `PATCH=0`, `DELETE=0`
+- Allowlisted operations: **22**
+- Methods: `GET=4`, `POST=18`, `PUT=0`, `PATCH=0`, `DELETE=0`
 - Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **48**
 - Typed tools: `auth_login`, `auth_logout`, `auth_status`, `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_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `hd_opposition`, `hd_planetary_return`, `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: 
@@ -234,7 +234,7 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 
 | Family | Operations | Example |
 |---|---:|---|
-| `acg` | 2 | `POST /acg/ccg`, `POST /acg/power-lines` |
+| `acg` | 4 | `POST /acg/ccg`, `POST /acg/hits` |
 | `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

@@ -19,6 +19,14 @@
       "method": "POST",
       "path": "/acg/ccg"
     },
+    {
+      "method": "POST",
+      "path": "/acg/hits"
+    },
+    {
+      "method": "POST",
+      "path": "/acg/local-space"
+    },
     {
       "method": "POST",
       "path": "/acg/power-lines"
@@ -96,8 +104,8 @@
       "path": "/visualization/chart-wheel"
     }
   ],
-  "last_generated_at": "2026-03-29T02:31:11.230Z",
-  "openapi_sha256": "c92376455af5f33481fd676a126d9b9436b30d5dd0c681d33258cf74a19ba18b",
+  "last_generated_at": "2026-04-03T20:52:05.270Z",
+  "openapi_sha256": "1203c3d6fd62c4af1b04ad983f9495a27f1799a13fcfd8aedc5189d118d5279a",
   "candidates_get": [
     {
       "method": "GET",
@@ -469,6 +477,14 @@
       ],
       "operationId": "features_acg_features_post"
     },
+    {
+      "method": "POST",
+      "path": "/acg/heatmap/composite",
+      "tags": [
+        "Astrocartography"
+      ],
+      "operationId": "AcgHeatmapCompositeAcgHeatmapCompositePost"
+    },
     {
       "method": "POST",
       "path": "/acg/hermetic-lines",
@@ -629,14 +645,6 @@
       ],
       "operationId": "calculate_harmonics_ephemeris_harmonics_post"
     },
-    {
-      "method": "POST",
-      "path": "/ephemeris/heatmap/score",
-      "tags": [
-        "Ephemeris"
-      ],
-      "operationId": "HeatmapScoreEphemerisHeatmapScorePost"
-    },
     {
       "method": "POST",
       "path": "/ephemeris/hermetic-lots",
@@ -979,6 +987,8 @@
     "errors": [],
     "warnings": [
       "Non-GET allowlisted: POST /acg/ccg",
+      "Non-GET allowlisted: POST /acg/hits",
+      "Non-GET allowlisted: POST /acg/local-space",
       "Non-GET allowlisted: POST /acg/power-lines",
       "Non-GET allowlisted: POST /comparative/composite/midpoint",
       "Non-GET allowlisted: POST /comparative/composite",

package/dist/backend/client.d.ts

@@ -65,3 +65,13 @@ export declare class BackendClient {
     getUserId(): string;
 }
 export declare const backendClient: BackendClient;
+/**
+ * Run `fn` in an async context where `getActiveClient()` returns `client`.
+ * Used by the SSE server to scope each connection to its own BackendClient.
+ */
+export declare function runWithClient<T>(client: BackendClient, fn: () => T): T;
+/**
+ * Returns the per-session BackendClient when called inside `runWithClient`,
+ * otherwise falls back to the module-level singleton (stdio mode).
+ */
+export declare function getActiveClient(): BackendClient;

package/dist/backend/client.js

@@ -1,3 +1,4 @@
+import { AsyncLocalStorage } from "node:async_hooks";
 import axios, { AxiosError } from "axios";
 import { CredentialManager } from "../auth/credentials.js";
 import { DeviceAuthFlow } from "../auth/device-auth.js";
@@ -352,7 +353,8 @@ export class BackendClient {
         return this.userId;
     }
 }
-// Singleton instance
+// Singleton instance — used by stdio server and as the fallback when no
+// session context is active.
 export const backendClient = new BackendClient({
     baseURL: process.env.OPENEPHEMERIS_BACKEND_URL ||
         process.env.ASTROMCP_BACKEND_URL ||
@@ -363,3 +365,24 @@ export const backendClient = new BackendClient({
     serviceKey: process.env.OPENEPHEMERIS_SERVICE_KEY || process.env.ASTROMCP_SERVICE_KEY || process.env.MERIDIAN_SERVICE_KEY,
     apiKey: process.env.OPENEPHEMERIS_API_KEY || process.env.ASTROMCP_API_KEY || process.env.MERIDIAN_API_KEY,
 });
+// ---------------------------------------------------------------------------
+// Per-session client context (SSE isolation)
+// ---------------------------------------------------------------------------
+// Each SSE connection creates its own BackendClient keyed to the user's API
+// key. AsyncLocalStorage propagates that client through the entire async call
+// chain of a tool invocation without touching the shared singleton.
+const _sessionClientStore = new AsyncLocalStorage();
+/**
+ * Run `fn` in an async context where `getActiveClient()` returns `client`.
+ * Used by the SSE server to scope each connection to its own BackendClient.
+ */
+export function runWithClient(client, fn) {
+    return _sessionClientStore.run(client, fn);
+}
+/**
+ * Returns the per-session BackendClient when called inside `runWithClient`,
+ * otherwise falls back to the module-level singleton (stdio mode).
+ */
+export function getActiveClient() {
+    return _sessionClientStore.getStore() ?? backendClient;
+}

package/dist/server-sse.js

@@ -21,7 +21,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
-import { backendClient } from "./backend/client.js";
+import { BackendClient, runWithClient } from "./backend/client.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -144,7 +144,7 @@ async function main() {
     app.use((_req, res, next) => {
         res.setHeader("Access-Control-Allow-Origin", "*");
         res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-API-Key, X-Meridian-API-Key");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-API-Key, X-OpenEphemeris-API-Key");
         if (_req.method === "OPTIONS") {
             res.status(204).end();
             return;
@@ -153,6 +153,8 @@ async function main() {
     });
     // Track active transports by session ID
     const transports = new Map();
+    // Per-session BackendClient — each connection authenticates independently.
+    const sessionClients = new Map();
     // Health check
     app.get("/health", (_req, res) => {
         res.json({ ok: true, version, transport: "sse", sessions: transports.size });
@@ -190,7 +192,7 @@ async function main() {
         // Extract API key from query param or header
         const apiKey = req.query.apiKey ||
             req.headers["x-api-key"] ||
-            req.headers["x-meridian-api-key"] ||
+            req.headers["x-openephemeris-api-key"] ||
             req.headers["authorization"]?.replace(/^Bearer\s+/i, "");
         if (!apiKey) {
             res.status(401).json({
@@ -208,12 +210,16 @@ async function main() {
             });
             return;
         }
-        // Inject the validated API key into the singleton BackendClient so all
-        // tool calls authenticate as this user and usage is metered correctly.
-        backendClient.setApiKey(apiKey);
         const transport = new SSEServerTransport("/message", res);
         const sessionId = transport.sessionId;
         transports.set(sessionId, transport);
+        // Create a per-session BackendClient so concurrent SSE connections
+        // don't overwrite each other's API key on the shared singleton.
+        const sessionClient = new BackendClient({
+            baseURL: BACKEND_URL,
+            apiKey,
+        });
+        sessionClients.set(sessionId, sessionClient);
         const server = createMcpServer();
         // Guard: prevent double-close from crashing the process
         let closed = false;
@@ -222,6 +228,7 @@ async function main() {
                 return;
             closed = true;
             transports.delete(sessionId);
+            sessionClients.delete(sessionId);
             try {
                 server.close().catch(() => { });
             }
@@ -243,6 +250,7 @@ async function main() {
     app.post("/message", async (req, res) => {
         const sessionId = req.query.sessionId;
         const transport = transports.get(sessionId);
+        const sessionClient = sessionClients.get(sessionId);
         if (!transport) {
             res.status(400).json({
                 error: "invalid_session",
@@ -250,7 +258,14 @@ async function main() {
             });
             return;
         }
-        await transport.handlePostMessage(req, res);
+        // Run handlePostMessage inside the session's client context so all tool
+        // handlers reach getActiveClient() and get this user's BackendClient.
+        if (sessionClient) {
+            await runWithClient(sessionClient, () => transport.handlePostMessage(req, res));
+        }
+        else {
+            await transport.handlePostMessage(req, res);
+        }
     });
     app.listen(PORT, "0.0.0.0", () => {
         console.log(`OpenEphemeris MCP SSE server v${version} listening on port ${PORT}`);

package/dist/tools/dev.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "./index.js";
-import { backendClient } from "../backend/client.js";
+import { getActiveClient } from "../backend/client.js";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -165,7 +165,13 @@ registerTool({
                 query.format = "llm";
             }
         }
-        return await backendClient.request(method, pathname, {
+        // Auto-inject format=png for visualization endpoints when no format specified.
+        // MCP image handlers only accept PNG/JPG/GIF/WEBP — SVG won't render inline.
+        const isVisualizationPath = pathname.startsWith("/visualization/") || pathname.startsWith("/comparative/visualization/");
+        if (isVisualizationPath && !query.format) {
+            query.format = "png";
+        }
+        return await getActiveClient().request(method, pathname, {
             params: query,
             data: body,
         });

package/dist/tools/specialized/acg.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.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. " +
@@ -68,7 +68,7 @@ registerTool({
             body.query_lon = args.query_longitude;
         if (args.radius_deg != null)
             body.radius_deg = args.radius_deg;
-        return await backendClient.post("/acg/power-lines", body);
+        return await getActiveClient().post("/acg/power-lines", body);
     },
 });
 // POST /acg/hits — OE-018
@@ -138,6 +138,6 @@ registerTool({
         if (args.include_aspects != null) {
             body.options = { include_aspects: args.include_aspects };
         }
-        return await backendClient.post("/acg/hits", body);
+        return await getActiveClient().post("/acg/hits", body);
     },
 });

package/dist/tools/specialized/bazi.js

@@ -1,5 +1,5 @@
 import { registerTool } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "chinese_bazi",
     description: "Calculate a Chinese Ba Zi (Four Pillars of Destiny) chart. Returns the Year, Month, Day, " +
@@ -62,6 +62,6 @@ registerTool({
         const body = { year, month, day };
         if (hour != null)
             body.hour = hour;
-        return await backendClient.request("POST", "/chinese/bazi", { data: body });
+        return await getActiveClient().request("POST", "/chinese/bazi", { data: body });
     },
 });

package/dist/tools/specialized/bi_wheel.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.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 = {
@@ -31,8 +31,8 @@ registerTool({
             },
             style: {
                 type: "string",
-                enum: ["modern", "classic", "dark"],
-                description: "Aesthetic style of the chart. Defaults to 'modern'.",
+                enum: ["light", "dark", "mono"],
+                description: "Aesthetic style of the chart: 'light' (default, warm cream background), 'dark' (deep navy), or 'mono' (black-and-white print-ready).",
             }
         },
         required: ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"],
@@ -69,6 +69,6 @@ registerTool({
             body.configuration = { house_system: mappedCode };
         }
         const styleParam = args.style ? `&style=${args.style}` : "";
-        return await backendClient.post(`/visualization/bi-wheel?format=png&size=800${styleParam}`, body);
+        return await getActiveClient().post(`/visualization/bi-wheel?format=png&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/chart_wheel.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.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 = {
@@ -39,8 +39,8 @@ registerTool({
             },
             style: {
                 type: "string",
-                enum: ["modern", "classic", "dark"],
-                description: "Aesthetic style of the chart. Defaults to 'modern'.",
+                enum: ["light", "dark", "mono"],
+                description: "Aesthetic style of the chart: 'light' (default, warm cream background), 'dark' (deep navy), or 'mono' (black-and-white print-ready).",
             }
         },
         required: ["datetime", "latitude", "longitude"],
@@ -66,6 +66,6 @@ registerTool({
             body.configuration = { house_system: mappedCode };
         }
         const styleParam = args.style ? `&style=${args.style}` : "";
-        return await backendClient.post(`/visualization/chart-wheel?format=png&size=800${styleParam}`, body);
+        return await getActiveClient().post(`/visualization/chart-wheel?format=png&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/comparative.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 function buildSubject(name, datetime, lat, lon, timezone) {
     const subj = {
         name,
@@ -50,7 +50,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/comparative/composite", {
+        return await getActiveClient().request("POST", "/comparative/composite", {
             params: query,
             data: {
                 subjects: [
@@ -94,7 +94,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/comparative/composite/midpoint", {
+        return await getActiveClient().request("POST", "/comparative/composite/midpoint", {
             params: query,
             data: {
                 subjects: [
@@ -138,7 +138,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/comparative/overlay", {
+        return await getActiveClient().request("POST", "/comparative/overlay", {
             params: query,
             data: {
                 subjects: [
@@ -182,7 +182,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/comparative/natal-transits", {
+        return await getActiveClient().request("POST", "/comparative/natal-transits", {
             params: query,
             data: { subjects }
         });

package/dist/tools/specialized/eclipse.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired, validateCoordinates } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_next_eclipse",
     description: "Find the next solar or lunar eclipse visible from a given location. " +
@@ -45,6 +45,6 @@ registerTool({
             params.date = args.after_date;
         if (args.eclipse_type && args.eclipse_type !== "any")
             params.type = args.eclipse_type;
-        return await backendClient.request("GET", "/eclipse/next-visible", { params, timeoutMs: 60_000 });
+        return await getActiveClient().request("GET", "/eclipse/next-visible", { params, timeoutMs: 60_000 });
     },
 });

package/dist/tools/specialized/electional.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 // All electional endpoints are GET endpoints with query params.
 // GET /electional/find-window — already existed, keeping it
 registerTool({
@@ -74,7 +74,7 @@ registerTool({
             query.avoid_voc = args.avoid_voc;
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("GET", "/electional/find-window", {
+        return await getActiveClient().request("GET", "/electional/find-window", {
             data: {},
             params: query,
         });
@@ -111,7 +111,7 @@ registerTool({
             query.date = args.date;
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("GET", "/electional/moment-analysis", {
+        return await getActiveClient().request("GET", "/electional/moment-analysis", {
             data: {},
             params: query,
         });
@@ -160,7 +160,7 @@ registerTool({
             query.planets = args.planets;
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("GET", "/electional/station-tracker", {
+        return await getActiveClient().request("GET", "/electional/station-tracker", {
             data: {},
             params: query,
         });
@@ -202,7 +202,7 @@ registerTool({
             query.max_orb = args.max_orb;
         if (args.aspects)
             query.aspects = args.aspects;
-        return await backendClient.request("GET", "/electional/aspect-search", {
+        return await getActiveClient().request("GET", "/electional/aspect-search", {
             data: {},
             params: query,
         });

package/dist/tools/specialized/ephemeris_core.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 // POST /ephemeris/planet-position — OE-016
 registerTool({
     name: "ephemeris_planet_position",
@@ -44,7 +44,7 @@ registerTool({
             body.latitude = args.latitude;
         if (args.longitude != null)
             body.longitude = args.longitude;
-        return await backendClient.post("/ephemeris/planet-position", body);
+        return await getActiveClient().post("/ephemeris/planet-position", body);
     },
 });
 // POST /ephemeris/house-cusps — OE-017
@@ -89,6 +89,6 @@ registerTool({
         };
         if (args.house_systems)
             body.house_systems = args.house_systems;
-        return await backendClient.post("/ephemeris/house-cusps", body);
+        return await getActiveClient().post("/ephemeris/house-cusps", body);
     },
 });

package/dist/tools/specialized/ephemeris_extended.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 function buildSubject(name, datetime, lat, lon) {
     return {
         name,
@@ -47,7 +47,7 @@ registerTool({
         const items = args.subjects.map((s) => ({
             subject: buildSubject(s.name, s.datetime, s.latitude, s.longitude),
         }));
-        return await backendClient.post("/ephemeris/natal/batch", { items });
+        return await getActiveClient().post("/ephemeris/natal/batch", { items });
     },
 });
 // POST /ephemeris/dignities
@@ -66,7 +66,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
-        return await backendClient.post("/ephemeris/dignities", {
+        return await getActiveClient().post("/ephemeris/dignities", {
             date_time: { iso: args.datetime },
         });
     },
@@ -93,7 +93,7 @@ registerTool({
         };
         if (args.planet_id != null)
             body.planet_id = args.planet_id;
-        return await backendClient.post("/ephemeris/retrograde-status", body);
+        return await getActiveClient().post("/ephemeris/retrograde-status", body);
     },
 });
 // POST /ephemeris/midpoints
@@ -114,7 +114,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
-        return await backendClient.post("/ephemeris/midpoints", {
+        return await getActiveClient().post("/ephemeris/midpoints", {
             date_time: { iso: args.datetime },
             latitude: args.latitude,
             longitude: args.longitude,
@@ -150,7 +150,7 @@ registerTool({
             body.star_names = args.star_names;
         if (args.orb != null)
             body.orb = args.orb;
-        return await backendClient.post("/ephemeris/fixed-stars", body);
+        return await getActiveClient().post("/ephemeris/fixed-stars", body);
     },
 });
 // POST /ephemeris/hermetic-lots
@@ -171,7 +171,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
-        return await backendClient.post("/ephemeris/hermetic-lots", {
+        return await getActiveClient().post("/ephemeris/hermetic-lots", {
             date_time: { iso: args.datetime },
             latitude: args.latitude,
             longitude: args.longitude,
@@ -196,7 +196,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
-        return await backendClient.post("/ephemeris/angles-points", {
+        return await getActiveClient().post("/ephemeris/angles-points", {
             date_time: { iso: args.datetime },
             latitude: args.latitude,
             longitude: args.longitude,
@@ -229,6 +229,6 @@ registerTool({
         };
         if (args.max_orb != null)
             body.max_orb = args.max_orb;
-        return await backendClient.post("/ephemeris/aspect-check", body);
+        return await getActiveClient().post("/ephemeris/aspect-check", body);
     },
 });

package/dist/tools/specialized/hd_cycles.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 /**
  * Ensure a datetime string has a timezone offset for Go's time.Time parsing.
  */
@@ -51,7 +51,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "return_year"]);
-        return await backendClient.request("POST", "/human-design/cycles/return", {
+        return await getActiveClient().request("POST", "/human-design/cycles/return", {
             data: {
                 planet: args.planet,
                 birth_datetime_utc: ensureTimezone(args.datetime),
@@ -101,7 +101,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "target_year"]);
-        return await backendClient.request("POST", "/human-design/cycles/opposition", {
+        return await getActiveClient().request("POST", "/human-design/cycles/opposition", {
             data: {
                 planet: args.planet,
                 birth_datetime_utc: ensureTimezone(args.datetime),

package/dist/tools/specialized/hd_group.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 // POST /human-design/composite — OE-027
 registerTool({
     name: "human_design_composite",
@@ -40,7 +40,7 @@ registerTool({
         };
         if (args.format)
             body.format = args.format;
-        return await backendClient.post("/human-design/composite", body);
+        return await getActiveClient().post("/human-design/composite", body);
     },
 });
 // POST /human-design/penta — OE-027
@@ -102,6 +102,6 @@ registerTool({
         };
         if (args.format)
             body.format = args.format;
-        return await backendClient.post("/human-design/penta", body);
+        return await getActiveClient().post("/human-design/penta", body);
     },
 });

package/dist/tools/specialized/human_design.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.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).
@@ -61,7 +61,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/human-design/chart", {
+        return await getActiveClient().request("POST", "/human-design/chart", {
             data: body,
             params: query,
         });

package/dist/tools/specialized/moon.js

@@ -1,5 +1,5 @@
 import { registerTool, validateCoordinates } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_moon_phase",
     description: "Get the current Moon phase and void-of-course status. Returns the Moon's sign, phase name " +
@@ -40,8 +40,8 @@ registerTool({
         if (args.longitude != null)
             params.longitude = args.longitude;
         const [phase, voc] = await Promise.allSettled([
-            backendClient.request("GET", "/ephemeris/moon/phase", { params }),
-            backendClient.request("GET", "/ephemeris/moon/void-of-course", { params }),
+            getActiveClient().request("GET", "/ephemeris/moon/phase", { params }),
+            getActiveClient().request("GET", "/ephemeris/moon/void-of-course", { params }),
         ]);
         return {
             phase: phase.status === "fulfilled" ? phase.value : { error: phase.reason?.message },

package/dist/tools/specialized/natal.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.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 Swiss Ephemeris single-letter codes */
@@ -91,7 +91,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/natal-chart", {
+        return await getActiveClient().request("POST", "/ephemeris/natal-chart", {
             data: body,
             params: query,
         });

package/dist/tools/specialized/progressed.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_progressed_chart",
     description: "Calculate a Secondary Progressed (or Solar Arc / Tertiary) chart. " +
@@ -60,6 +60,6 @@ registerTool({
         if (args.include_aspects != null) {
             body.options = { include_aspects: args.include_aspects };
         }
-        return await backendClient.post("/ephemeris/progressed", body);
+        return await getActiveClient().post("/ephemeris/progressed", body);
     },
 });

package/dist/tools/specialized/relocation.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_relocation",
     description: "Calculate a relocation chart — the same natal planetary positions re-cast for a different " +
@@ -67,7 +67,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/relocation", {
+        return await getActiveClient().request("POST", "/ephemeris/relocation", {
             data: body,
             params: query,
         });

package/dist/tools/specialized/returns.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 // POST /predictive/returns/solar
 registerTool({
     name: "ephemeris_solar_return",
@@ -57,7 +57,7 @@ registerTool({
                 longitude: { decimal: args.return_longitude },
             };
         }
-        return await backendClient.post("/predictive/returns/solar", body);
+        return await getActiveClient().post("/predictive/returns/solar", body);
     },
 });
 // POST /predictive/returns/lunar
@@ -103,7 +103,7 @@ registerTool({
                 longitude: { decimal: args.birth_longitude },
             };
         }
-        return await backendClient.post("/predictive/returns/lunar", body);
+        return await getActiveClient().post("/predictive/returns/lunar", body);
     },
 });
 // POST /predictive/returns (generic planetary return)
@@ -138,7 +138,7 @@ registerTool({
     },
     handler: async (args) => {
         validateRequired(args, ["body", "birth_datetime", "target_datetime"]);
-        return await backendClient.post("/predictive/returns", {
+        return await getActiveClient().post("/predictive/returns", {
             body: args.body,
             birth_datetime: { iso: args.birth_datetime },
             target_datetime: { iso: args.target_datetime },

package/dist/tools/specialized/synastry.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_synastry",
     description: "Calculate a synastry chart comparing two people's natal charts. Returns inter-aspects " +
@@ -63,7 +63,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/comparative/synastry", {
+        return await getActiveClient().request("POST", "/comparative/synastry", {
             data: body,
             params: query,
         });

package/dist/tools/specialized/transits.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "ephemeris_transits",
     description: "Search for astrological transit events affecting a natal chart over a date range. " +
@@ -76,7 +76,7 @@ registerTool({
                 },
             },
         };
-        const natalResult = await backendClient.post("/ephemeris/natal-chart", natalBody);
+        const natalResult = await getActiveClient().post("/ephemeris/natal-chart", natalBody);
         // Extract ecliptic longitudes from natal chart planets
         const targetDegrees = [];
         const natalPositionMap = {};
@@ -141,7 +141,7 @@ registerTool({
             // Also include aspect metadata for labeling in results
             transitBody.search_criteria = { aspect_angle: args.aspect_angle };
         }
-        const transitResult = await backendClient.request("POST", "/predictive/transits/search", { data: transitBody });
+        const transitResult = await getActiveClient().request("POST", "/predictive/transits/search", { data: transitBody });
         // Return combined context so the LLM knows what natal positions were targeted
         return {
             natal_positions: natalPositionMap,

package/dist/tools/specialized/vedic.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired, validateCoordinates } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 registerTool({
     name: "vedic_chart",
     description: "Calculate a Vedic (Jyotish) natal chart with sidereal positions. Returns planet placements " +
@@ -43,6 +43,6 @@ registerTool({
         };
         if (args.ayanamsa)
             body.ayanamsa = args.ayanamsa;
-        return await backendClient.request("POST", "/vedic/chart", { data: body });
+        return await getActiveClient().request("POST", "/vedic/chart", { data: body });
     },
 });

package/dist/tools/specialized/venus_star_points.js

@@ -1,5 +1,5 @@
 import { registerTool, validateRequired } from "../index.js";
-import { backendClient } from "../../backend/client.js";
+import { getActiveClient } from "../../backend/client.js";
 function buildSubject(datetime, lat, lon) {
     return {
         name: "Subject",
@@ -34,7 +34,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points", {
             data: { subject: buildSubject(args.datetime, args.latitude, args.longitude) },
             params: query,
         });
@@ -63,7 +63,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points/conjunctions", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points/conjunctions", {
             data: { start_date: args.start_date, end_date: args.end_date },
             params: query,
         });
@@ -92,7 +92,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points/eight-year-star", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points/eight-year-star", {
             data: { date: args.date },
             params: query,
         });
@@ -120,7 +120,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points/phase", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points/phase", {
             data: { date: args.date },
             params: query,
         });
@@ -147,7 +147,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points/elongations", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points/elongations", {
             data: { start_date: args.start_date, end_date: args.end_date },
             params: query,
         });
@@ -176,7 +176,7 @@ registerTool({
         const query = {};
         if (args.format)
             query.format = args.format;
-        return await backendClient.request("POST", "/ephemeris/venus-star-points/stations", {
+        return await getActiveClient().request("POST", "/ephemeris/venus-star-points/stations", {
             data: {
                 start_date: args.start_date,
                 end_date: args.end_date || "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -42,6 +42,9 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
+    "modelcontextprotocol",
+    "model-context-protocol",
     "astrology",
     "astronomy",
     "ephemeris",
@@ -52,22 +55,27 @@
     "swiss ephemeris"
   ],
   "author": "Open Ephemeris",
+  "homepage": "https://openephemeris.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Spirit-River/openephemeris-MCP.git"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.3",
-    "axios": "^1.13.2",
-    "express": "^5.1.0",
-    "zod": "^4.1.13"
+    "@modelcontextprotocol/sdk": "1.24.3",
+    "axios": "1.13.2",
+    "express": "5.1.0",
+    "zod": "4.1.13"
   },
   "devDependencies": {
-    "@types/express": "^5.0.3",
-    "@types/node": "^25.0.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "@types/express": "5.0.3",
+    "@types/node": "25.0.1",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15"
   },
   "packageManager": "pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a"
 }