@openephemeris/mcp-server 3.13.5 → 3.13.7

package/dist/tools/apps/bi-wheel-app.js

@@ -304,14 +304,6 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                     { type: "text", text: JSON.stringify({ ...payload, server_version: SERVER_VERSION }) },
-                    {
-                        type: "resource",
-                        resource: {
-                            uri: BI_WHEEL_RESOURCE_URI,
-                            mimeType: BI_WHEEL_MIME_TYPE,
-                            text: getBiWheelBundle(),
-                        },
-                    },
                 ],
                 _meta: {
                     ui: { resourceUri: BI_WHEEL_RESOURCE_URI },

package/dist/tools/apps/bodygraph-app.js

@@ -286,14 +286,6 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                     { type: "text", text: JSON.stringify({ ...modelPayload, server_version: SERVER_VERSION }) },
-                    {
-                        type: "resource",
-                        resource: {
-                            uri: BODYGRAPH_RESOURCE_URI,
-                            mimeType: BODYGRAPH_MIME_TYPE,
-                            text: getBodygraphBundle(),
-                        },
-                    },
                 ],
                 _meta: {
                     ui: { resourceUri: BODYGRAPH_RESOURCE_URI },

package/dist/tools/apps/chart-wheel-app.js

@@ -182,14 +182,6 @@ registerTool({
                 content: [
                     { type: "text", text: summary },
                     { type: "text", text: JSON.stringify({ ...modelPayload, server_version: SERVER_VERSION }) },
-                    {
-                        type: "resource",
-                        resource: {
-                            uri: CHART_WHEEL_RESOURCE_URI,
-                            mimeType: CHART_WHEEL_MIME_TYPE,
-                            text: getChartWheelBundle(),
-                        },
-                    },
                 ],
                 _meta: {
                     ui: { resourceUri: CHART_WHEEL_RESOURCE_URI },
@@ -453,7 +445,10 @@ function buildModelPayload(chartData, birthParams, houseSystem, svgBase) {
     // ── 2. Compute aspects from longitude data (API doesn't return them) ──────
     const aspects = computeAspects(planetsArray);
     return {
-        ...chartData,
+        ascendant: chartData.ascendant,
+        midheaven: chartData.midheaven,
+        chart_ruler: chartData.chart_ruler,
+        houses: chartData.houses,
         // Typed array replaces the keyed object — the renderer can now iterate it
         planets: planetsArray,
         // Structured aspect array — powers highlighting and info panel

package/dist/tools/specialized/acg.js

@@ -54,6 +54,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude"]);
         const body = {
@@ -146,6 +147,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"]);
         const body = {

package/dist/tools/specialized/bazi.js

@@ -39,6 +39,7 @@ registerTool({
         },
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         let year = args.year;
         let month = args.month;

package/dist/tools/specialized/bi_wheel.js

@@ -38,6 +38,7 @@ registerTool({
         required: ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"]);
         const body = {

package/dist/tools/specialized/chart_wheel.js

@@ -46,6 +46,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/comparative.js

@@ -42,6 +42,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -86,6 +87,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -130,6 +132,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -171,6 +174,7 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude"]);
         // Backend expects: { subject: {...}, transit_datetime?: {...} }

package/dist/tools/specialized/eclipse.js

@@ -40,6 +40,7 @@ registerTool({
         required: ["eclipse_type"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["eclipse_type"]);
         validateCoordinates(args, "latitude", "longitude");

package/dist/tools/specialized/electional.js

@@ -56,6 +56,7 @@ registerTool({
         required: ["start_date", "end_date", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date", "latitude", "longitude"]);
         const query = {
@@ -105,6 +106,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         if (args.date)
@@ -155,6 +157,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         // Map human-readable planet names to IDs if needed
@@ -213,6 +216,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         if (args.date)

package/dist/tools/specialized/ephemeris_core.js

@@ -34,6 +34,7 @@ registerTool({
         required: ["planet_id", "datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet_id", "datetime"]);
         const body = {
@@ -80,6 +81,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/ephemeris_extended.js

@@ -42,6 +42,7 @@ registerTool({
         required: ["subjects"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["subjects"]);
         const items = args.subjects.map((s) => ({
@@ -64,6 +65,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         return await getActiveClient().post("/ephemeris/dignities", {
@@ -90,6 +92,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const client = getActiveClient();
@@ -138,6 +141,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/midpoints", {
@@ -167,6 +171,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {
@@ -226,6 +231,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/hermetic-lots", {
@@ -251,6 +257,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/angles-points", {
@@ -278,6 +285,7 @@ registerTool({
         required: ["longitude_1", "longitude_2"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["longitude_1", "longitude_2"]);
         // Backend field names are longitude1 / longitude2 (no underscore)

package/dist/tools/specialized/hd_bodygraph.js

@@ -39,6 +39,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/hd_cycles.js

@@ -49,6 +49,7 @@ registerTool({
         required: ["planet", "datetime", "return_year"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "return_year"]);
         return await getActiveClient().request("POST", "/human-design/cycles/return", {
@@ -99,6 +100,7 @@ registerTool({
         required: ["planet", "datetime", "target_year"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "target_year"]);
         return await getActiveClient().request("POST", "/human-design/cycles/opposition", {

package/dist/tools/specialized/hd_group.js

@@ -28,6 +28,7 @@ registerTool({
         required: ["person_a_datetime", "person_b_datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["person_a_datetime", "person_b_datetime"]);
         const body = {
@@ -87,6 +88,7 @@ registerTool({
         required: ["group_name", "members"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["group_name", "members"]);
         const members = args.members.map((m) => ({

package/dist/tools/specialized/human_design.js

@@ -64,6 +64,7 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/moon.js

@@ -33,6 +33,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateCoordinates(args, "latitude", "longitude");
         const params = {};
@@ -90,6 +91,7 @@ registerTool({
         required: ["phase"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         // Map our clean enum to display names the calendar API returns
         const phaseNameMap = {

package/dist/tools/specialized/natal.js

@@ -73,6 +73,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/progressed.js

@@ -56,6 +56,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"]);
         const body = {

package/dist/tools/specialized/relocation.js

@@ -46,6 +46,7 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"]);
         const body = {

package/dist/tools/specialized/returns.js

@@ -59,6 +59,7 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         // Default target to current year if not provided
@@ -126,6 +127,7 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         const targetDt = args.target_datetime ?? new Date().toISOString();
@@ -180,6 +182,7 @@ registerTool({
         required: ["body", "birth_datetime", "target_datetime"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["body", "birth_datetime", "target_datetime"]);
         const requestBody = {

package/dist/tools/specialized/synastry.js

@@ -50,6 +50,7 @@ registerTool({
         ],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",

package/dist/tools/specialized/transits.js

@@ -66,6 +66,7 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
         // ── Step 1: Compute natal chart to extract real planetary longitudes ──

package/dist/tools/specialized/vedic.js

@@ -33,6 +33,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         validateCoordinates(args, "latitude", "longitude");

package/dist/tools/specialized/venus_star_points.js

@@ -29,6 +29,7 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const query = {};
@@ -58,6 +59,7 @@ registerTool({
         required: ["start_date", "end_date"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date"]);
         const query = {};
@@ -87,6 +89,7 @@ registerTool({
         required: ["date"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["date"]);
         const query = {};
@@ -117,6 +120,7 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         if (args.format)
@@ -143,6 +147,7 @@ registerTool({
         required: ["start_date", "end_date"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date"]);
         const query = {};
@@ -172,6 +177,7 @@ registerTool({
         required: ["start_date"],
         additionalProperties: false,
     },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date"]);
         const query = {};

package/package.json

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