@openephemeris/mcp-server 3.2.0 → 3.2.2

package/dist/src/tools/dev.js

@@ -1,4 +1,4 @@
-import { registerTool } from "./index.js";
+import { registerTool, validateRequired } from "./index.js";
 import { backendClient } from "../backend/client.js";
 import fs from "node:fs";
 import path from "node:path";
@@ -10,8 +10,10 @@ function getAllowlistPath() {
     // dist lives at mcp-server/dist; src lives at mcp-server/src.
     // We resolve relative to current file location for both dev+prod.
     const here = path.dirname(fileURLToPath(import.meta.url));
-    // here: .../dist/tools OR .../src/tools
-    const mcpServerRoot = path.resolve(here, "..", "..");
+    let mcpServerRoot = path.resolve(here, "..", "..");
+    if (path.basename(mcpServerRoot) === "dist") {
+        mcpServerRoot = path.resolve(mcpServerRoot, "..");
+    }
     return path.join(mcpServerRoot, "config", "dev-allowlist.json");
 }
 function loadAllowlist() {
@@ -30,10 +32,10 @@ function isAllowedOperation(method, pathname, allow) {
     return allow.some((e) => e.method === method && e.path === pathname);
 }
 registerTool({
-    name: "dev.call",
+    name: "dev_call",
     description: "Call any allowlisted Open Ephemeris API endpoint directly. This is the power-user escape hatch " +
-        "— use the typed tools (ephemeris.natal_chart, ephemeris.transits, etc.) first for common operations. " +
-        "Call dev.list_allowed to see all currently available endpoint paths.\n\n" +
+        "— use the typed tools (ephemeris_natal_chart, ephemeris_transits, etc.) first for common operations. " +
+        "Call dev_list_allowed to see all currently available endpoint paths.\n\n" +
         "AUTH: Set OPENEPHEMERIS_API_KEY in your environment. See openephemeris.com/dashboard for active plan limits.\n\n" +
         "CREDIT COSTS:\n" +
         "  • Standard chart math (natal, progressed, bazi, HD): 1 credit\n" +
@@ -44,7 +46,7 @@ registerTool({
         "  • Catalog / metadata / health endpoints: 0 credits\n" +
         "  • format=llm (token-optimized output): available on all tiers\n\n" +
         "COMMON CALLS:\n" +
-        "  POST /ephemeris/natal-chart            — Full natal chart (body: {datetime, latitude, longitude})\n" +
+        "  POST /ephemeris/natal-chart            — Full natal chart (body: {subject: {name: 'Name', birth_datetime: {iso: '1990-04-15T14:30:00-05:00'}, birth_location: {latitude: {decimal: 40.0}, longitude: {decimal: -70.0}, timezone: {}}}})\n" +
         "  POST /ephemeris/natal/batch            — Up to 50 natal charts in one request\n" +
         "  POST /ephemeris/relocation             — Relocated chart (same natal, new location)\n" +
         "  POST /predictive/transits/search       — Transit event search over a date range\n" +
@@ -52,15 +54,16 @@ registerTool({
         "  POST /predictive/returns/lunar         — Lunar return chart\n" +
         "  POST /comparative/synastry             — Two-person synastry chart\n" +
         "  POST /comparative/composite            — Composite (midpoint) chart\n" +
-        "  POST /human-design/chart               — Full HD bodygraph\n" +
+        "  POST /human-design/chart               — Full HD bodygraph (body: {birth_datetime_utc: '1990-04-15T19:30:00Z'}) — lat/lon optional\n" +
+        "  POST /time/julian-day                  — Convert date to JD (body: {year: 1987, month: 7, day: 15, hour: 14, minute: 1})\n" +
         "  GET  /ephemeris/moon/phase             — Current/queried moon phase\n" +
         "  GET  /ephemeris/moon/void-of-course    — Next void-of-course period\n" +
         "  GET  /ephemeris/agro/daily             — Biodynamic farming day quality\n" +
         "  GET  /ephemeris/agro/calendar          — Multi-day biodynamic calendar\n" +
         "  GET  /ephemeris/agro/void-of-course    — Biodynamic VoC periods\n" +
+        "  GET  /eclipse/next-visible             — Next eclipse visible from a location (query: lat, lon, type=solar|lunar)\n" +
         "  GET  /eclipse/solar/global             — Next global solar eclipse (query: date=YYYY-MM-DD)\n" +
-        "  GET  /eclipse/solar/local              — Local solar eclipse (query: latitude, longitude)\n" +
-        "  GET  /eclipse/next-visible             — Next eclipse visible from a location\n" +
+        "  GET  /eclipse/solar/local              — Local solar eclipse (query: lat, lon)\n" +
         "  GET  /tidal/forcing                    — Gravitational tidal forcing index\n" +
         "  GET  /tidal/forcing/deep-time          — Extended tidal deep-time analysis\n" +
         "  POST /acg/power-lines                 — Astrocartography power lines (lat/lon GeoJSON)\n" +
@@ -68,9 +71,9 @@ registerTool({
         "  GET  /calendar/astrology/moon-phases   — Moon phase calendar for a date range\n" +
         "  GET  /location/autocomplete            — Geocode a place name (query: q=City Name)\n" +
         "  POST /timezone/lookup                  — Resolve timezone + UTC offset for a location\n" +
-        "  POST /chinese/bazi                     — Chinese Ba Zi (Four Pillars) chart\n" +
+        "  POST /chinese/bazi                     — Chinese Ba Zi (Four Pillars) chart (body: {year, month, day, hour})\n" +
         "  GET  /chinese/zodiac                   — Chinese zodiac year element/animal\n" +
-        "  POST /vedic/chart                      — Vedic (Jyotish) natal chart\n" +
+        "  POST /vedic/chart                      — Vedic (Jyotish) natal chart (body: {datetime_utc, latitude, longitude})\n" +
         "  GET  /catalogs/bodies                  — List all supported celestial bodies\n\n" +
         "BINARY RESPONSES:\n" +
         "  • Binary/image endpoints return {content_type, content_length, encoding, data_base64}\n" +
@@ -118,8 +121,13 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
-        const method = String(args.method || "").toUpperCase();
-        const pathname = String(args.path || "");
+        validateRequired(args, ["path"]);
+        const methodStr = String(args.method || "GET").toUpperCase();
+        if (!["GET", "POST", "PUT", "PATCH", "DELETE"].includes(methodStr)) {
+            throw new Error(`Invalid HTTP method: ${methodStr}`);
+        }
+        const method = methodStr;
+        const pathname = String(args.path);
         if (!pathname.startsWith("/")) {
             throw new Error("path must start with '/'");
         }
@@ -161,12 +169,12 @@ registerTool({
     },
 });
 registerTool({
-    name: "dev.list_allowed",
+    name: "dev_list_allowed",
     description: "List all API operations (method + path) that this MCP instance is authorized to call. " +
         "Returns endpoint entries grouped by method, plus the active deny rules. " +
-        "Use this to discover what's available before calling dev.call, or to verify an endpoint path. " +
-        "Typed shortcut tools (ephemeris.natal_chart, ephemeris.transits, etc.) cover the most common operations — " +
-        "check those first before reaching for dev.call.",
+        "Use this to discover what's available before calling dev_call, or to verify an endpoint path. " +
+        "Typed shortcut tools (ephemeris_natal_chart, ephemeris_transits, etc.) cover the most common operations — " +
+        "check those first before reaching for dev_call.",
     inputSchema: {
         type: "object",
         properties: {},

package/dist/src/tools/index.d.ts

@@ -23,3 +23,11 @@ export type ToolProfile = "dev" | "legacy";
  * - `legacy`: registers only the generic tools (back-compat).
  */
 export declare function initTools(profile?: ToolProfile): Promise<void>;
+/**
+ * Throws an error if any of the required keys are missing or empty.
+ */
+export declare function validateRequired(args: any, requiredKeys: string[]): void;
+/**
+ * Throws an error if only one of the coordinate pair is provided.
+ */
+export declare function validateCoordinates(args: any, latKey: string, lonKey: string): void;

package/dist/src/tools/index.js

@@ -31,3 +31,26 @@ export async function initTools(profile) {
         await import("./specialized/electional.js");
     }
 }
+/**
+ * Throws an error if any of the required keys are missing or empty.
+ */
+export function validateRequired(args, requiredKeys) {
+    if (!args)
+        throw new Error("Missing arguments object.");
+    const missing = requiredKeys.filter((k) => args[k] == null || args[k] === "");
+    if (missing.length > 0) {
+        throw new Error(`Missing required arguments: ${missing.join(", ")}`);
+    }
+}
+/**
+ * Throws an error if only one of the coordinate pair is provided.
+ */
+export function validateCoordinates(args, latKey, lonKey) {
+    if (!args)
+        return;
+    const hasLat = args[latKey] != null && args[latKey] !== "";
+    const hasLon = args[lonKey] != null && args[lonKey] !== "";
+    if (hasLat !== hasLon) {
+        throw new Error(`Both ${latKey} and ${lonKey} must be provided together, or both omitted.`);
+    }
+}

package/dist/src/tools/specialized/eclipse.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired, validateCoordinates } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.next_eclipse",
+    name: "ephemeris_next_eclipse",
     description: "Find the next solar or lunar eclipse visible from a given location (or globally). " +
         "Returns the eclipse type, date/time of maximum, magnitude, duration of totality (if any), " +
         "and local contact times if coordinates are provided.\n\n" +
@@ -35,22 +35,19 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["eclipse_type"]);
+        validateCoordinates(args, "latitude", "longitude");
         const params = {};
         if (args.latitude != null)
-            params.latitude = args.latitude;
+            params.lat = args.latitude;
         if (args.longitude != null)
-            params.longitude = args.longitude;
+            params.lon = args.longitude;
         if (args.after_date)
             params.date = args.after_date;
-        if (args.eclipse_type === "solar") {
-            // Use local endpoint if coordinates provided, otherwise global
-            if (args.latitude != null && args.longitude != null) {
-                return await backendClient.request("GET", "/eclipse/solar/local", { params, timeoutMs: 60_000 });
-            }
-            return await backendClient.request("GET", "/eclipse/solar/global", { params, timeoutMs: 60_000 });
-        }
-        else {
-            return await backendClient.request("GET", "/eclipse/lunar/global", { params, timeoutMs: 60_000 });
-        }
+        if (args.eclipse_type)
+            params.type = args.eclipse_type;
+        // Use /eclipse/next-visible which is the unified endpoint
+        // that accepts lat/lon and type filters
+        return await backendClient.request("GET", "/eclipse/next-visible", { params, timeoutMs: 60_000 });
     },
 });

package/dist/src/tools/specialized/electional.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.electional",
+    name: "ephemeris_electional",
     description: "Find optimal planetary timing windows (electional astrology). Scans a date range to find the " +
         "best times for an event based on essential dignity, aspect quality, sect, and void-of-course " +
         "moon penalties. Evaluates every hour and clusters the best continuous windows.\n\n" +
@@ -55,6 +55,7 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["start_date", "end_date", "latitude", "longitude"]);
         const query = {
             start_date: args.start_date,
             end_date: args.end_date,

package/dist/src/tools/specialized/human_design.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "human_design.chart",
+    name: "human_design_chart",
     description: "Calculate a full Human Design bodygraph chart from birth data. Returns the person's Type " +
         "(Generator, Manifesting Generator, Projector, Manifestor, Reflector), Strategy, Authority, " +
         "Profile (e.g. 1/3, 2/4), defined and undefined Centers, activated Gates and Channels, " +
@@ -37,8 +37,9 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {
-            datetime: args.datetime,
+            birth_datetime_utc: args.datetime,
             latitude: args.latitude,
             longitude: args.longitude,
         };

package/dist/src/tools/specialized/moon.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateCoordinates } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.moon_phase",
+    name: "ephemeris_moon_phase",
     description: "Get the current Moon phase and void-of-course status. Returns the Moon's sign, phase name " +
         "(New, Waxing Crescent, First Quarter, Waxing Gibbous, Full, Waning Gibbous, Last Quarter, " +
         "Waning Crescent), exact phase angle, illumination percentage, and the next void-of-course period.\n\n" +
@@ -31,6 +31,7 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateCoordinates(args, "latitude", "longitude");
         const params = {};
         if (args.datetime)
             params.datetime = args.datetime;

package/dist/src/tools/specialized/natal.js

@@ -1,9 +1,9 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } 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'.";
 registerTool({
-    name: "ephemeris.natal_chart",
+    name: "ephemeris_natal_chart",
     description: "Calculate a full natal (birth) chart for a person. Returns planetary positions, house cusps, " +
         "aspects, and chart patterns. Use format='llm' for a compact, token-efficient output ideal for " +
         "interpretation (available on all tiers). The result includes all major planets, angles (ASC/MC/DSC/IC), " +
@@ -38,28 +38,37 @@ registerTool({
             },
             include_arabic_parts: {
                 type: "boolean",
-                description: "If true, include Hermetic Lots (Arabic Parts) in the response.",
+                description: "Reserved for future use. Hermetic Lots / Arabic Parts are currently available via the dedicated /ephemeris/hermetic-lots endpoint.",
             },
             include_fixed_stars: {
                 type: "boolean",
-                description: "If true, include fixed star conjunctions in the response.",
+                description: "Reserved for future use. Fixed star positions are currently available via the dedicated /ephemeris/fixed-stars endpoint.",
             },
         },
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {
-            datetime: args.datetime,
-            latitude: args.latitude,
-            longitude: args.longitude,
+            subject: {
+                name: "MCP Request",
+                birth_datetime: { iso: args.datetime },
+                birth_location: {
+                    latitude: { decimal: args.latitude },
+                    longitude: { decimal: args.longitude }
+                },
+            }
         };
-        if (args.house_system)
-            body.house_system = args.house_system;
-        if (args.include_arabic_parts)
-            body.include_arabic_parts = args.include_arabic_parts;
-        if (args.include_fixed_stars)
-            body.include_fixed_stars = args.include_fixed_stars;
+        if (args.house_system) {
+            body.configuration = { house_system: args.house_system };
+        }
+        if (args.include_arabic_parts || args.include_fixed_stars) {
+            body.options = {
+                ...(args.include_arabic_parts && { include_arabic_parts: args.include_arabic_parts }),
+                ...(args.include_fixed_stars && { include_fixed_stars: args.include_fixed_stars }),
+            };
+        }
         const query = {};
         if (args.format)
             query.format = args.format;

package/dist/src/tools/specialized/relocation.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.relocation",
+    name: "ephemeris_relocation",
     description: "Calculate a relocation chart — the same natal planetary positions re-cast for a different " +
         "geographic location. Used to understand how living in a different city shifts house placements " +
         "and angles, without changing the planetary longitudes in the chart.\n\n" +
@@ -47,16 +47,21 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"]);
         const body = {
             natal: {
-                datetime: args.natal_datetime,
-                latitude: args.natal_latitude,
-                longitude: args.natal_longitude,
-            },
-            relocation: {
-                latitude: args.relocation_latitude,
-                longitude: args.relocation_longitude,
+                subject: {
+                    name: "MCP Request",
+                    birth_datetime: { iso: args.natal_datetime },
+                    birth_location: {
+                        latitude: { decimal: args.natal_latitude },
+                        longitude: { decimal: args.natal_longitude },
+                        timezone: {},
+                    },
+                },
             },
+            relocation_lat: args.relocation_latitude,
+            relocation_lon: args.relocation_longitude,
         };
         if (args.house_system)
             body.house_system = args.house_system;

package/dist/src/tools/specialized/synastry.js

@@ -1,11 +1,11 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.synastry",
+    name: "ephemeris_synastry",
     description: "Calculate a synastry chart comparing two people's natal charts. Returns inter-aspects " +
         "(planetary connections between the two charts), composite points, and relationship indicators. " +
         "Use this for compatibility analysis, relationship timing, or partnership insights.\n\n" +
-        "CREDIT COST: 5 credits per call.\n\n" +
+        "CREDIT COST: 3 credits per call.\n\n" +
         "EXAMPLE: Compare two people's charts:\n" +
         "  person_a_datetime='1990-04-15T14:30:00', person_a_latitude=41.8781, person_a_longitude=-87.6298,\n" +
         "  person_b_datetime='1988-09-22T08:15:00', person_b_latitude=34.0522, person_b_longitude=-118.2437",
@@ -36,16 +36,28 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, [
+            "person_a_datetime", "person_a_latitude", "person_a_longitude",
+            "person_b_datetime", "person_b_latitude", "person_b_longitude",
+        ]);
         const body = {
-            natal_a: {
-                datetime: args.person_a_datetime,
-                latitude: args.person_a_latitude,
-                longitude: args.person_a_longitude,
+            subject_a: {
+                name: "Person A",
+                birth_datetime: { iso: args.person_a_datetime },
+                birth_location: {
+                    latitude: { decimal: args.person_a_latitude },
+                    longitude: { decimal: args.person_a_longitude },
+                    timezone: {},
+                },
             },
-            natal_b: {
-                datetime: args.person_b_datetime,
-                latitude: args.person_b_latitude,
-                longitude: args.person_b_longitude,
+            subject_b: {
+                name: "Person B",
+                birth_datetime: { iso: args.person_b_datetime },
+                birth_location: {
+                    latitude: { decimal: args.person_b_latitude },
+                    longitude: { decimal: args.person_b_longitude },
+                    timezone: {},
+                },
             },
         };
         if (args.house_system)

package/dist/src/tools/specialized/transits.js

@@ -1,7 +1,7 @@
-import { registerTool } from "../index.js";
+import { registerTool, validateRequired } from "../index.js";
 import { backendClient } from "../../backend/client.js";
 registerTool({
-    name: "ephemeris.transits",
+    name: "ephemeris_transits",
     description: "Search for astrological transit events affecting a natal chart over a date range. " +
         "Returns a list of exact transit moments — when transiting planets form specified aspects " +
         "to natal planet positions. Ideal for generating horoscope timelines, event forecasting, or " +
@@ -58,23 +58,30 @@ registerTool({
         additionalProperties: false,
     },
     handler: async (args) => {
+        validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
+        let startStr = args.start_date;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(startStr)) {
+            startStr += "T00:00:00Z";
+        }
+        let endStr = args.end_date;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(endStr)) {
+            endStr += "T23:59:59Z";
+        }
         const body = {
-            natal: {
-                datetime: args.natal_datetime,
-                latitude: args.natal_latitude,
-                longitude: args.natal_longitude,
-            },
-            start_date: args.start_date,
-            end_date: args.end_date,
+            start_date: startStr,
+            end_date: endStr,
         };
         if (args.transiting_planets)
-            body.transiting_planets = args.transiting_planets;
+            body.planet_names = args.transiting_planets;
+        const searchCriteria = {};
         if (args.natal_points)
-            body.natal_points = args.natal_points;
+            searchCriteria.natal_points = args.natal_points;
         if (args.aspects)
-            body.aspects = args.aspects;
+            searchCriteria.aspects = args.aspects;
         if (args.orb != null)
-            body.orb = args.orb;
+            searchCriteria.orb = args.orb;
+        if (Object.keys(searchCriteria).length > 0)
+            body.search_criteria = searchCriteria;
         return await backendClient.request("POST", "/predictive/transits/search", { data: body });
     },
 });

package/dist/test/allowlist-and-tools.test.js

@@ -66,19 +66,19 @@ describe("toolRegistry", () => {
     });
     it("registers all expected tools", () => {
         const expectedTools = [
-            "auth.login",
-            "auth.status",
-            "auth.logout",
-            "dev.call",
-            "dev.list_allowed",
-            "ephemeris.natal_chart",
-            "ephemeris.transits",
-            "ephemeris.moon_phase",
-            "ephemeris.next_eclipse",
-            "ephemeris.synastry",
-            "ephemeris.relocation",
-            "ephemeris.electional",
-            "human_design.chart",
+            "auth_login",
+            "auth_status",
+            "auth_logout",
+            "dev_call",
+            "dev_list_allowed",
+            "ephemeris_natal_chart",
+            "ephemeris_transits",
+            "ephemeris_moon_phase",
+            "ephemeris_next_eclipse",
+            "ephemeris_synastry",
+            "ephemeris_relocation",
+            "ephemeris_electional",
+            "human_design_chart",
         ];
         for (const name of expectedTools) {
             expect(toolRegistry[name], `Missing tool: ${name}`).toBeDefined();

package/dist/test/backend-client.test.js

@@ -92,9 +92,7 @@ describe("BackendClient", () => {
                 baseURL: srv.baseURL,
             });
             const message = await getErrorMessage(() => client.get("/secure"));
-            expect(message).toContain("Authentication required:");
-            expect(message).toContain("auth.login");
-            expect(message).toContain("OPENEPHEMERIS_API_KEY");
+            expect(message).toMatch(/Account connection required|Authentication required:/);
         }
         finally {
             await srv.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -18,9 +18,13 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx watch src/index.ts",
+    "dev:sse": "tsx watch src/server-sse.ts",
     "start": "node dist/index.js",
+    "start:sse": "node dist/src/server-sse.js",
     "test": "vitest run --exclude \"dist/**\"",
     "test:watch": "vitest --exclude \"dist/**\"",
+    "test:integration": "tsx scripts/test-client.ts",
+    "test:sse": "tsx scripts/test-sse-client.ts",
     "typecheck": "tsc --noEmit",
     "regen:dev-allowlist": "tsx scripts/dev-allowlist.ts --write",
     "check:dev-allowlist": "tsx scripts/dev-allowlist.ts --check",
@@ -48,9 +52,11 @@
   "dependencies": {
     "@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",