@openephemeris/mcp-server 3.2.4 → 3.2.6

package/dist/src/index.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry } from "./tools/index.js";
 function resolveServerVersion() {
     try {
@@ -33,6 +33,7 @@ const server = new Server({
 }, {
     capabilities: {
         tools: {},
+        prompts: {},
     },
 });
 // List available tools
@@ -50,6 +51,47 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         })),
     };
 });
+// List available prompts
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    return {
+        prompts: [
+            {
+                name: "welcome_to_open_ephemeris",
+                description: "Getting started guide for the Open Ephemeris MCP. Use this to orient yourself to available tools, astrology terminology, and usage.",
+            }
+        ]
+    };
+});
+// Get prompt content
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    if (request.params.name !== "welcome_to_open_ephemeris") {
+        throw new Error(`Unknown prompt: ${request.params.name}`);
+    }
+    return {
+        description: "Open Ephemeris Agent & Developer Orientation",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Welcome to the **Open Ephemeris MCP Server**!\n\n" +
+                        "You are now connected to an enterprise-grade astrological and astronomical computation engine powered by NASA JPL DE440 and DE441 ephemeris data. As a generative guide, here is how you can best utilize these tools to help the user:\n\n" +
+                        "### Core Capabilities\n" +
+                        "- **Birth Charts:** Use `ephemeris_natal_chart` for full planetary positions, houses, dignities, and aspects.\n" +
+                        "- **Predictive Timing:** `ephemeris_transits` searches for exact dates when transiting planets hit natal points.\n" +
+                        "- **Location Astrology:** `ephemeris_relocation` projects a natal chart to a new geographic location (Astrocartography).\n" +
+                        "- **Specialized Modalities:** Dedicated tools for `vedic_chart`, `chinese_bazi`, and `human_design_chart`.\n" +
+                        "- **Eclipse Hunter:** `ephemeris_next_eclipse` dynamically scans 20 years for the next total or partial hit at the user's location.\n\n" +
+                        "### Best Practices for AI Agents\n" +
+                        "1. **Coordinate Formatting:** Always convert addresses/city names into `latitude` and `longitude` decimals *before* calling the tools (e.g., Chicago is `41.8781, -87.6298`).\n" +
+                        "2. **Datetime Handling:** Most endpoints accept ISO 8601 strings. If you have a local birth time but the endpoint asks for UTC, explicitly append a `Z` or timezone offset (e.g., `1990-04-15T19:30:00Z`).\n" +
+                        "3. **Token Efficiency:** Our responses are hyper-condensed to save you context space. You don't need to struggle with raw JSON arrays; interpret the condensed strings directly (e.g., `Su 15°Pi30 H10`).\n\n" +
+                        "You're equipped with professional-grade math. Start by asking the user if they'd like to calculate a natal chart, check recent transits, or explore another modality!"
+                }
+            }
+        ]
+    };
+});
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const toolName = request.params.name;

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

@@ -70,10 +70,15 @@ registerTool({
             const code = HOUSE_SYSTEM_MAP[args.house_system] ?? args.house_system;
             body.configuration = { house_system: code };
         }
-        if (args.include_arabic_parts || args.include_fixed_stars) {
+        if (args.include_fixed_stars) {
+            body.configuration = {
+                ...(body.configuration || {}),
+                fixed_star_options: { include: true }
+            };
+        }
+        if (args.include_arabic_parts) {
             body.options = {
-                ...(args.include_arabic_parts && { include_arabic_parts: args.include_arabic_parts }),
-                ...(args.include_fixed_stars && { include_fixed_stars: args.include_fixed_stars }),
+                include_hermetic_lots: true,
             };
         }
         const query = {};

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

@@ -70,6 +70,11 @@ registerTool({
         const body = {
             start_date: startStr,
             end_date: endStr,
+            natal_chart: {
+                datetime: args.natal_datetime,
+                latitude: args.natal_latitude,
+                longitude: args.natal_longitude,
+            },
         };
         if (args.transiting_planets)
             body.planet_names = args.transiting_planets;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.2.4",
+  "version": "3.2.6",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",