@openephemeris/mcp-server 3.13.9 → 3.14.0

package/dist/tools/specialized/chart_wheel.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE } from "../output-schemas.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 = {
@@ -46,7 +47,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE,
+    annotations: { title: "Chart Wheel SVG", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/comparative.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 function buildSubject(name, datetime, lat, lon, timezone) {
     const subj = {
         name,
@@ -42,7 +43,8 @@ registerTool({
         ],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Davison Relationship Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -87,7 +89,8 @@ registerTool({
         ],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Midpoint Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -132,7 +135,8 @@ registerTool({
         ],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Planet Compatibility Score", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -174,7 +178,8 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Composite Chart Aspects", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired, validateCoordinates } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_next_eclipse",
     description: "Find the next solar or lunar eclipse. " +
@@ -40,7 +41,8 @@ registerTool({
         required: ["eclipse_type"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Eclipse Finder", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["eclipse_type"]);
         validateCoordinates(args, "latitude", "longitude");

package/dist/tools/specialized/electional.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 // All electional endpoints are GET endpoints with query params.
 // GET /electional/find-window — already existed, keeping it
 registerTool({
@@ -56,7 +57,8 @@ registerTool({
         required: ["start_date", "end_date", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Electional Timing Window", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date", "latitude", "longitude"]);
         const query = {
@@ -106,7 +108,8 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Moment Quality Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         if (args.date)
@@ -157,7 +160,8 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Retrograde Station Tracker", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         // Map human-readable planet names to IDs if needed
@@ -216,7 +220,8 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Active Aspects Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const query = {};
         if (args.date)

package/dist/tools/specialized/ephemeris_core.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 // POST /ephemeris/planet-position — OE-016
 registerTool({
     name: "ephemeris_planet_position",
@@ -34,7 +35,8 @@ registerTool({
         required: ["planet_id", "datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Planet Position", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet_id", "datetime"]);
         const body = {
@@ -81,7 +83,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "House Cusps", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/ephemeris_extended.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 function buildSubject(name, datetime, lat, lon) {
     return {
         name,
@@ -42,7 +43,8 @@ registerTool({
         required: ["subjects"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Natal Batch Charts", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["subjects"]);
         const items = args.subjects.map((s) => ({
@@ -65,7 +67,8 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Essential Dignities", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         return await getActiveClient().post("/ephemeris/dignities", {
@@ -92,7 +95,8 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Retrograde Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const client = getActiveClient();
@@ -141,7 +145,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Midpoints", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/midpoints", {
@@ -171,7 +176,8 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Fixed Stars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {
@@ -231,7 +237,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Hermetic Lots", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/hermetic-lots", {
@@ -257,7 +264,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Angles & Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/angles-points", {
@@ -285,7 +293,8 @@ registerTool({
         required: ["longitude_1", "longitude_2"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Aspect Check", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 /** Append 'Z' if no timezone offset is present in the datetime string. */
 function ensureTimezone(dt) {
     if (/[Zz]$/.test(dt) || /[+-]\d{2}:\d{2}$/.test(dt))
@@ -39,7 +40,8 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Human Design Bodygraph", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/hd_cycles.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 /**
  * Ensure a datetime string has a timezone offset for Go's time.Time parsing.
  */
@@ -49,7 +50,8 @@ registerTool({
         required: ["planet", "datetime", "return_year"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "HD Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "return_year"]);
         return await getActiveClient().request("POST", "/human-design/cycles/return", {
@@ -100,7 +102,8 @@ registerTool({
         required: ["planet", "datetime", "target_year"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "HD Opposition Chart", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 // POST /human-design/composite — OE-027
 registerTool({
     name: "human_design_composite",
@@ -28,7 +29,8 @@ registerTool({
         required: ["person_a_datetime", "person_b_datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["person_a_datetime", "person_b_datetime"]);
         const body = {
@@ -88,7 +90,8 @@ registerTool({
         required: ["group_name", "members"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "HD Penta Group Chart", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.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).
@@ -64,7 +65,8 @@ registerTool({
         required: ["datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/moon.js

@@ -1,5 +1,6 @@
 import { registerTool, validateCoordinates } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_moon_phase",
     description: "Get the Moon's current phase angle, illumination, and void-of-course status AT a specific " +
@@ -33,7 +34,8 @@ registerTool({
         required: [],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateCoordinates(args, "latitude", "longitude");
         const params = {};
@@ -91,7 +93,8 @@ registerTool({
         required: ["phase"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Next Lunar Phase", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.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 standard single-letter codes */
@@ -73,7 +74,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/progressed.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_progressed_chart",
     description: "Calculate a Secondary Progressed (or Solar Arc / Tertiary) chart. " +
@@ -56,7 +57,8 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Progressed Chart", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_relocation",
     description: "Calculate a relocation chart — the same natal planetary positions re-cast for a different " +
@@ -46,7 +47,8 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Relocation Chart", 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

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 // POST /predictive/returns/solar
 registerTool({
     name: "ephemeris_solar_return",
@@ -59,7 +60,8 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Solar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         // Default target to current year if not provided
@@ -127,7 +129,8 @@ registerTool({
         required: ["birth_datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Lunar Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime"]);
         const targetDt = args.target_datetime ?? new Date().toISOString();
@@ -182,7 +185,8 @@ registerTool({
         required: ["body", "birth_datetime", "target_datetime"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["body", "birth_datetime", "target_datetime"]);
         const requestBody = {

package/dist/tools/specialized/synastry.js

@@ -1,5 +1,6 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 registerTool({
     name: "ephemeris_synastry",
     description: "Calculate a synastry chart comparing two people's natal charts. Returns inter-aspects " +
@@ -50,7 +51,8 @@ registerTool({
         ],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
+    annotations: { title: "Synastry Chart", 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

@@ -1,27 +1,22 @@
 import { registerTool, validateRequired } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     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 " +
-        "finding optimal timing windows.\n\n" +
-        "HOW IT WORKS: This tool first calculates the natal chart to extract your actual planetary " +
-        "ecliptic longitudes, then searches for transiting planets crossing those exact degrees.\n\n" +
-        "ASPECT ANGLES: Use aspect_angle to search for specific aspects to natal positions:\n" +
+        "Returns exact transit moments — when transiting planets form specified aspects " +
+        "to natal planet positions.\n\n" +
+        "EFFICIENCY TIP: Always specify both transiting_planets and natal_points to keep " +
+        "compute fast. Omitting both sends all outer planets against all core natal positions " +
+        "— a much heavier computation.\n\n" +
+        "ASPECT ANGLES: Use aspect_angle to search for specific aspects:\n" +
         "  0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine.\n" +
         "  Example: Saturn Return → transiting_planets=['saturn'], natal_points=['saturn'], aspect_angle=0\n" +
         "  Example: Uranus Opposition → transiting_planets=['uranus'], natal_points=['uranus'], aspect_angle=180\n" +
-        "  Example: Chiron Return → transiting_planets=['chiron'], natal_points=['chiron'], aspect_angle=0\n\n" +
-        "SUPPORTED BODIES: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, " +
-        "Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode.\n\n" +
-        "CREDIT COST: 6 credits per call (1 for natal + 5 for transit search). " +
-        "Requests exceeding 30 seconds incur 1 additional credit per 30s of compute time.\n\n" +
-        "SEARCH RANGE LIMITS: Explorer tier is limited to 1-year windows; Developer to 5 years. " +
-        "Ranges exceeding the limit are silently clamped.\n\n" +
-        "EXAMPLE: Find all Saturn transits to the natal Sun/Moon for the next 6 months:\n" +
-        "  natal_datetime='1990-04-15T14:30:00', natal_latitude=41.8781, natal_longitude=-87.6298,\n" +
-        "  start_date='2026-01-01', end_date='2026-06-30', transiting_planets=['saturn']",
+        "  Example: Outer planets to natal Sun/Moon → transiting_planets=['saturn','uranus','neptune','pluto'], natal_points=['sun','moon']\n\n" +
+        "DEFAULT natal_points (when omitted): sun, moon, mercury, venus, mars, jupiter, saturn.\n" +
+        "SEARCH RANGE LIMITS: Explorer/PayG tier → 1 year max; Developer → 5 years; Startup → 10 years.\n" +
+        "CREDIT COST: 6 credits per call.",
     inputSchema: {
         type: "object",
         properties: {
@@ -66,7 +61,8 @@ registerTool({
         required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Transit Search", 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 ──
@@ -87,35 +83,49 @@ registerTool({
         // The natal response typically has a `planets` array or object
         const planets = natalResult?.planets || natalResult?.data?.planets || [];
         const planetArray = Array.isArray(planets) ? planets : Object.values(planets);
-        // Filter to requested natal points if specified
+        // ── Core bodies used when no natal_points filter is given ────────────
+        // Defaulting to all planets creates 40+ serial SearchTransit calls on the
+        // backend (10+ targets × 4+ outer planets). Cap to the 7 classical bodies.
+        const CORE_BODIES_DEFAULT = new Set([
+            "sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn",
+        ]);
         const wantedPoints = args.natal_points
             ? new Set(args.natal_points.map((p) => p.toLowerCase()))
-            : null;
+            : CORE_BODIES_DEFAULT;
         for (const planet of planetArray) {
             const name = (planet.name || planet.id || "").toLowerCase();
             const lon = planet.longitude ?? planet.ecliptic_longitude ?? planet.lon;
             if (typeof lon !== "number" || !isFinite(lon))
                 continue;
-            if (wantedPoints && !wantedPoints.has(name))
+            if (!wantedPoints.has(name))
                 continue;
-            targetDegrees.push(Math.round(lon * 100) / 100); // 2 decimal places
+            targetDegrees.push(Math.round(lon * 100) / 100);
             natalPositionMap[name] = lon;
         }
-        // Also extract angles (ASC, MC, DSC, IC) if present
-        const angles = natalResult?.angles || natalResult?.data?.angles;
-        if (angles) {
-            const angleEntries = Array.isArray(angles) ? angles : Object.entries(angles).map(([k, v]) => ({ name: k, ...(typeof v === 'object' ? v : { longitude: v }) }));
-            for (const angle of angleEntries) {
-                const name = (angle.name || angle.id || "").toLowerCase();
-                const lon = angle.longitude ?? angle.ecliptic_longitude ?? angle.lon;
-                if (typeof lon !== "number" || !isFinite(lon))
-                    continue;
-                if (wantedPoints && !wantedPoints.has(name))
-                    continue;
-                targetDegrees.push(Math.round(lon * 100) / 100);
-                natalPositionMap[name] = lon;
+        // Extract angles (ASC, MC) only when explicitly requested
+        if (args.natal_points) {
+            const angles = natalResult?.angles || natalResult?.data?.angles;
+            if (angles) {
+                const angleEntries = Array.isArray(angles)
+                    ? angles
+                    : Object.entries(angles).map(([k, v]) => ({ name: k, ...(typeof v === "object" ? v : { longitude: v }) }));
+                for (const angle of angleEntries) {
+                    const name = (angle.name || angle.id || "").toLowerCase();
+                    const lon = angle.longitude ?? angle.ecliptic_longitude ?? angle.lon;
+                    if (typeof lon !== "number" || !isFinite(lon))
+                        continue;
+                    if (!wantedPoints.has(name))
+                        continue;
+                    targetDegrees.push(Math.round(lon * 100) / 100);
+                    natalPositionMap[name] = lon;
+                }
             }
         }
+        // Hard cap: never send more than 12 target degrees
+        const MAX_TARGETS = 12;
+        if (targetDegrees.length > MAX_TARGETS) {
+            targetDegrees.splice(MAX_TARGETS);
+        }
         if (targetDegrees.length === 0) {
             throw new Error("Could not extract natal planet longitudes from the natal chart calculation. " +
                 "Please verify your natal_datetime, natal_latitude, and natal_longitude are correct.");
@@ -129,23 +139,22 @@ registerTool({
         if (/^\d{4}-\d{2}-\d{2}$/.test(endStr)) {
             endStr += "T23:59:59Z";
         }
+        const aspectAngle = typeof args.aspect_angle === "number" ? args.aspect_angle : 0;
+        let effectiveTargets = targetDegrees;
+        if (aspectAngle !== 0) {
+            effectiveTargets = targetDegrees.map((deg) => ((deg + aspectAngle) % 360 + 360) % 360);
+        }
         const transitBody = {
             start_date: startStr,
             end_date: endStr,
-            target_degrees: targetDegrees,
+            target_degrees: effectiveTargets,
         };
         if (args.transiting_planets)
             transitBody.planet_names = args.transiting_planets;
-        // When aspect_angle is provided, apply offset to compute effective target degrees
-        // (natal_lon + aspect_angle) mod 360 for each natal point
-        let effectiveTargets = targetDegrees;
-        if (typeof args.aspect_angle === "number" && args.aspect_angle !== 0) {
-            effectiveTargets = targetDegrees.map((deg) => ((deg + args.aspect_angle) % 360 + 360) % 360);
-            transitBody.target_degrees = effectiveTargets;
-            // Also include aspect metadata for labeling in results
-            transitBody.search_criteria = { aspect_angle: args.aspect_angle };
+        if (aspectAngle !== 0) {
+            transitBody.search_criteria = { aspect_angle: aspectAngle };
         }
-        const transitResult = await getActiveClient().request("POST", "/predictive/transits/search", { data: transitBody });
+        const transitResult = await getActiveClient().request("POST", "/predictive/transits/search", { data: transitBody, timeoutMs: 90_000 });
         // 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,6 @@
 import { registerTool, validateRequired, validateCoordinates } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
+import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 registerTool({
     name: "vedic_chart",
     description: "Calculate a Vedic (Jyotish) natal chart with sidereal positions. Returns planet placements " +
@@ -33,7 +34,8 @@ registerTool({
         required: ["datetime", "latitude", "longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "Vedic Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         validateCoordinates(args, "latitude", "longitude");