kundali-chart-mcp 0.2.1

package/index.js

@@ -0,0 +1,747 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const bridgePath = join(__dirname, "kundali_bridge.py");
+const packageDir = __dirname;
+const pythonCommand = process.env.KUNDALI_MCP_PYTHON || "python3";
+
+const server = new McpServer({
+  name: "kundali-chart",
+  version: "0.1.0",
+});
+
+function callBridge(toolName, payload) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(pythonCommand, [bridgePath, toolName], {
+      cwd: packageDir,
+      stdio: ["pipe", "pipe", "pipe"],
+      env: process.env,
+    });
+
+    let stdout = "";
+    let stderr = "";
+
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk;
+    });
+
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+
+    child.on("error", (error) => {
+      reject(new Error(`Failed to start Python bridge: ${error.message}`));
+    });
+
+    child.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error(stderr || `Python bridge exited with code ${code}`));
+        return;
+      }
+
+      try {
+        resolve(JSON.parse(stdout));
+      } catch (error) {
+        reject(
+          new Error(`Python bridge returned invalid JSON: ${error.message}`),
+        );
+      }
+    });
+
+    child.stdin.end(JSON.stringify(payload));
+  });
+}
+
+function jsonContent(data) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(data, null, 2),
+      },
+    ],
+  };
+}
+
+server.tool(
+  "generate_kundali",
+  "Generate a Vedic Kundali birth chart from birth details.",
+  {
+    name: z.string().describe("Person's name."),
+    city: z
+      .string()
+      .describe(
+        "Birth city/place. Used for geocoding if coordinates are not provided.",
+      ),
+    date_of_birth: z.string().describe("Birth date in YYYY-MM-DD format."),
+    time_of_birth: z
+      .string()
+      .describe("Birth time in HH:MM or HH:MM:SS format, local to birthplace."),
+    latitude: z
+      .number()
+      .optional()
+      .describe(
+        "Optional birthplace latitude. Must be provided with longitude.",
+      ),
+    longitude: z
+      .number()
+      .optional()
+      .describe(
+        "Optional birthplace longitude. Must be provided with latitude.",
+      ),
+    timezone: z
+      .string()
+      .optional()
+      .describe("Optional IANA timezone, for example Asia/Kolkata."),
+    chart_type: z
+      .string()
+      .optional()
+      .describe(
+        "Optional chart type. Default is lagna. Supported: lagna/rashi/d1, chandra, surya, d2, d3, d4, d7, d9, d10, d12, d16, d20, d24, d27, d30, d40, d45, d60, all, all_divisionals.",
+      ),
+    ayanamsa_mode: z
+      .string()
+      .optional()
+      .describe(
+        "Optional sidereal mode. Default 'lahiri'. Use list_ayanamsa_modes to see all supported modes.",
+      ),
+    house_system: z
+      .string()
+      .optional()
+      .describe(
+        "Optional house system code: P (Placidus), K (Koch), E (Equal), N (Whole Sign), etc. Default 'P'. Use list_house_systems to see all.",
+      ),
+  },
+  async (args) => jsonContent(await callBridge("generate_kundali", args)),
+);
+
+server.tool(
+  "list_available_chart_types",
+  "List supported Kundali chart types and aliases accepted by generate_kundali.",
+  {},
+  async (args) =>
+    jsonContent(await callBridge("list_available_chart_types", args)),
+);
+
+server.tool(
+  "list_ayanamsa_modes",
+  "List all sidereal (ayanamsa) modes supported by the underlying Swiss Ephemeris engine.",
+  {},
+  async (args) => jsonContent(await callBridge("list_ayanamsa_modes", args)),
+);
+
+server.tool(
+  "list_house_systems",
+  "List all house systems supported by the underlying Swiss Ephemeris engine.",
+  {},
+  async (args) => jsonContent(await callBridge("list_house_systems", args)),
+);
+
+server.tool(
+  "search_birth_places",
+  "Search birth-place suggestions for choosing chart coordinates.",
+  {
+    query: z.string().describe("Place/city search text. Minimum 2 characters."),
+    limit: z
+      .number()
+      .int()
+      .min(1)
+      .max(10)
+      .optional()
+      .describe("Maximum number of suggestions to return."),
+  },
+  async (args) => jsonContent(await callBridge("search_birth_places", args)),
+);
+
+server.tool(
+  "get_timezone_for_coordinates",
+  "Get the IANA timezone for a latitude/longitude pair.",
+  {
+    latitude: z.number().describe("Latitude."),
+    longitude: z.number().describe("Longitude."),
+  },
+  async (args) =>
+    jsonContent(await callBridge("get_timezone_for_coordinates", args)),
+);
+
+server.tool(
+  "get_transit_positions",
+  "Get sidereal Lahiri planetary transit positions for now or a specific UTC datetime.",
+  {
+    datetime_utc: z
+      .string()
+      .optional()
+      .describe(
+        "Optional ISO UTC datetime, for example 2026-06-20T12:00:00Z. If omitted, current UTC time is used.",
+      ),
+  },
+  async (args) => jsonContent(await callBridge("get_transit_positions", args)),
+);
+
+const extendedBirthInput = {
+  year: z.number().int().describe("Birth year, e.g. 1998."),
+  month: z.number().int().min(1).max(12).describe("Birth month (1–12)."),
+  day: z.number().int().min(1).max(31).describe("Birth day (1–31)."),
+  hour: z
+    .number()
+    .int()
+    .min(0)
+    .max(23)
+    .describe("Birth hour in 24h local time."),
+  minute: z.number().int().min(0).max(59).describe("Birth minute."),
+  second: z
+    .number()
+    .int()
+    .min(0)
+    .max(59)
+    .optional()
+    .describe("Birth second. Defaults to 0."),
+  utc_offset: z
+    .string()
+    .describe("UTC offset of birthplace, e.g. '+05:30', '-04:00', '+00:00'."),
+  latitude: z.number().describe("Birthplace latitude."),
+  longitude: z.number().describe("Birthplace longitude."),
+  ayanamsa: z
+    .string()
+    .optional()
+    .describe(
+      "Optional ayanamsa. Default 'Lahiri'. Supported: Lahiri, Lahiri_1940, Lahiri_VP285, Lahiri_ICRC, Raman, Krishnamurti, Krishnamurti_Senthilathiban. Use list_extended_options to see all.",
+    ),
+  house_system: z
+    .string()
+    .optional()
+    .describe(
+      "Optional house system. Default 'Placidus'. Supported: Placidus, Equal, Equal 2, Whole Sign. Use list_extended_options to see all.",
+    ),
+};
+
+server.tool(
+  "get_extended_chart",
+  "Get enhanced Kundali chart with SubLord/KP data, Nakshatra SubLords for planets and house cusps. Uses vedicastro engine.",
+  extendedBirthInput,
+  async (args) => jsonContent(await callBridge("get_extended_chart", args)),
+);
+
+server.tool(
+  "get_vimshottari_dasha",
+  "Get Vimshottari Dasha (mahadasha + antardasha) periods for a birth chart. Uses vedicastro engine.",
+  extendedBirthInput,
+  async (args) => jsonContent(await callBridge("get_vimshottari_dasha", args)),
+);
+
+server.tool(
+  "get_planetary_aspects",
+  "Get all planetary aspects (conjunction, sextile, square, trine, opposition, semi-sextile, etc.) for a birth chart. Uses vedicastro engine.",
+  extendedBirthInput,
+  async (args) => jsonContent(await callBridge("get_planetary_aspects", args)),
+);
+
+server.tool(
+  "get_significators",
+  "Get planet-wise and house-wise significators (KP system) for a birth chart. Uses vedicastro engine.",
+  extendedBirthInput,
+  async (args) => jsonContent(await callBridge("get_significators", args)),
+);
+
+server.tool(
+  "list_extended_options",
+  "List supported ayanamsas and house systems for the extended vedicastro-powered tools.",
+  {},
+  async (args) => jsonContent(await callBridge("list_extended_options", args)),
+);
+
+// ─── Standard birth input (for pyswisseph tools) ───────────────────────────
+const standardBirthInput = {
+  name: z.string().optional().describe("Person's name."),
+  city: z
+    .string()
+    .optional()
+    .describe("Birth city. Used for geocoding if coordinates not provided."),
+  date_of_birth: z.string().describe("Birth date YYYY-MM-DD."),
+  time_of_birth: z
+    .string()
+    .describe("Birth time HH:MM or HH:MM:SS, local to birthplace."),
+  latitude: z
+    .number()
+    .optional()
+    .describe("Birth latitude. Must come with longitude."),
+  longitude: z
+    .number()
+    .optional()
+    .describe("Birth longitude. Must come with latitude."),
+  timezone: z.string().optional().describe("IANA timezone, e.g. Asia/Kolkata."),
+  ayanamsa_mode: z
+    .string()
+    .optional()
+    .describe("Ayanamsa, default 'lahiri'. Use list_ayanamsa_modes."),
+  house_system: z
+    .string()
+    .optional()
+    .describe("House system code, default 'P'. Use list_house_systems."),
+};
+
+// ─── Panchanga ─────────────────────────────────────────────────────────────
+server.tool(
+  "get_panchanga",
+  "Get Panchanga (5 Vedic time limbs: Tithi, Vara, Nakshatra, Yoga, Karana) for any datetime and location.",
+  {
+    datetime: z.string().optional().describe("ISO datetime. Defaults to now."),
+    timezone: z.string().optional().describe("IANA timezone."),
+    ayanamsa_mode: z.string().optional().describe("Ayanamsa, default lahiri."),
+  },
+  async (args) => jsonContent(await callBridge("get_panchanga", args)),
+);
+
+// ─── Doshas ────────────────────────────────────────────────────────────────
+server.tool(
+  "get_doshas",
+  "Check all major doshas: Mangal Dosha, Kaal Sarp Dosha, Sade Sati, Graha Yuddha (planetary war), and Combustion.",
+  {
+    ...standardBirthInput,
+    current_saturn_rashi: z
+      .string()
+      .optional()
+      .describe("Current Saturn sign for Sade Sati check, e.g. 'Pisces'."),
+  },
+  async (args) => jsonContent(await callBridge("get_doshas", args)),
+);
+
+// ─── Yogas ─────────────────────────────────────────────────────────────────
+server.tool(
+  "get_yogas",
+  "Identify all major Vedic Yogas: Pancha Mahapurusha, Raj Yoga, Gaja Kesari, Dhana, Viparita Raj, Parivartana, Neecha Bhanga, and more.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_yogas", args)),
+);
+
+// ─── Compatibility ─────────────────────────────────────────────────────────
+server.tool(
+  "get_compatibility",
+  "Ashtakoot Milan: 36-point Vedic marriage compatibility scoring across all 8 kootas (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi).",
+  {
+    chart1: z
+      .object(standardBirthInput)
+      .describe("First person's birth details."),
+    chart2: z
+      .object(standardBirthInput)
+      .describe("Second person's birth details."),
+  },
+  async (args) => jsonContent(await callBridge("get_compatibility", args)),
+);
+
+// ─── Special Conditions ────────────────────────────────────────────────────
+server.tool(
+  "get_special_conditions",
+  "Check Vargottama, Pushkara Navamsha, Dig Bala (directional strength), and Jaimini Karakas for a birth chart.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_special_conditions", args)),
+);
+
+// ─── Pratyantar Dasha ──────────────────────────────────────────────────────
+server.tool(
+  "get_pratyantar_dasha",
+  "Get 3-level Vimshottari Dasha: Mahadasha → Antardasha → Pratyantar Dasha with exact start/end dates.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_pratyantar_dasha", args)),
+);
+
+// ─── Yogini Dasha ──────────────────────────────────────────────────────────
+server.tool(
+  "get_yogini_dasha",
+  "Get Yogini Dasha (8-yogini, 36-year cycle: Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, Sankata).",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_yogini_dasha", args)),
+);
+
+// ─── Varshaphal ────────────────────────────────────────────────────────────
+server.tool(
+  "get_varshaphal",
+  "Get Varshaphal (Solar Return chart) — the chart for the exact moment the Sun returns to its natal longitude in a given year of life.",
+  {
+    ...standardBirthInput,
+    year_of_life: z
+      .number()
+      .int()
+      .describe("Which year's solar return to calculate, e.g. 26."),
+    query_latitude: z
+      .number()
+      .optional()
+      .describe("Current location latitude. Defaults to birth location."),
+    query_longitude: z
+      .number()
+      .optional()
+      .describe("Current location longitude. Defaults to birth location."),
+    query_timezone: z
+      .string()
+      .optional()
+      .describe("Current location timezone. Defaults to birth timezone."),
+  },
+  async (args) => jsonContent(await callBridge("get_varshaphal", args)),
+);
+
+// ─── Ashtakavarga ──────────────────────────────────────────────────────────
+server.tool(
+  "get_ashtakavarga",
+  "Get Ashtakavarga — benefic point scores for all 12 houses for each of 7 planets (BAV) and total (SAV). Used for transit predictions.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_ashtakavarga", args)),
+);
+
+// ─── Shadbala ──────────────────────────────────────────────────────────────
+server.tool(
+  "get_shadbala",
+  "Get Shadbala — six-fold planetary strength: Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, and Drik Bala.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_shadbala", args)),
+);
+
+// ─── Jaimini ───────────────────────────────────────────────────────────────
+server.tool(
+  "get_jaimini",
+  "Get full Jaimini astrology: Chara Karakas (Atmakaraka, Amatyakaraka, etc.), sign-based aspects, and Karakamsha.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_jaimini", args)),
+);
+
+// ─── Muhurta ───────────────────────────────────────────────────────────────
+server.tool(
+  "get_muhurta",
+  "Score a specific datetime for Muhurta (auspicious timing) based on Panchanga for a given event type (marriage, business, travel, housewarming, education, general).",
+  {
+    datetime: z
+      .string()
+      .optional()
+      .describe("ISO datetime to score. Defaults to now."),
+    timezone: z.string().optional().describe("IANA timezone."),
+    event_type: z
+      .string()
+      .optional()
+      .describe(
+        "Event type: marriage, business, travel, housewarming, education, general.",
+      ),
+  },
+  async (args) => jsonContent(await callBridge("get_muhurta", args)),
+);
+
+server.tool(
+  "get_best_muhurta",
+  "Find the top 5 most auspicious Muhurta windows within a date range for a specific event type.",
+  {
+    start_datetime: z
+      .string()
+      .describe("Range start in ISO format, e.g. 2026-07-01T00:00:00."),
+    end_datetime: z
+      .string()
+      .describe("Range end in ISO format, e.g. 2026-07-15T23:59:59."),
+    timezone: z.string().optional().describe("IANA timezone for the range."),
+    latitude: z.number().optional().describe("Location latitude."),
+    longitude: z.number().optional().describe("Location longitude."),
+    event_type: z
+      .string()
+      .optional()
+      .describe(
+        "Event type: marriage, business, travel, housewarming, education, general.",
+      ),
+  },
+  async (args) => jsonContent(await callBridge("get_best_muhurta", args)),
+);
+
+// ─── Batch 2: Comprehensive Vedic Astrology tools ───────────────────────────────
+
+server.tool(
+  "get_avasthas",
+  "Get planetary Avasthas (9 states: Deepta, Swastha, Mudita, Santha, Dina, Dukhita, Vikala, Khala, Bhadra) and Baladi Avasthas (infant/youth/old/dead) for each planet.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_avasthas", args)),
+);
+
+server.tool(
+  "get_upagrahas",
+  "Get Upagrahas (shadow sub-planets): Gulika, Mandi, Dhuma, Vyatipata, Parivesha, Indra Chapa, Upaketu — with rashi, house, and significance.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_upagrahas", args)),
+);
+
+server.tool(
+  "get_gandanta",
+  "Check which planets are in Gandanta zones (sensitive junctions between water and fire signs: Scorpio-Sagittarius, Pisces-Aries, Cancer-Leo).",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_gandanta", args)),
+);
+
+server.tool(
+  "get_kartari",
+  "Check Kartari Yoga: planets or houses hemmed between benefics (Subha Kartari — auspicious) or malefics (Papa Kartari — harmful).",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_kartari", args)),
+);
+
+server.tool(
+  "get_nakshatra_analysis",
+  "Get deep Nakshatra information for each planet: deity, symbol, gana, element, quality, body part, padas, and keywords. Also lookup any specific nakshatra.",
+  {
+    ...standardBirthInput,
+    nakshatra_name: z
+      .string()
+      .optional()
+      .describe("Optional: get details for a specific nakshatra by name."),
+  },
+  async (args) => jsonContent(await callBridge("get_nakshatra_analysis", args)),
+);
+
+server.tool(
+  "get_gochara",
+  "Get Gochara (Vedic transit analysis): how current or specified transiting planets affect natal Moon houses, with Vedha (obstruction) checks, Sade Sati, and Kantaka Shani.",
+  {
+    ...standardBirthInput,
+    transit_datetime: z
+      .string()
+      .optional()
+      .describe("ISO datetime for transit analysis. Defaults to now."),
+  },
+  async (args) => jsonContent(await callBridge("get_gochara", args)),
+);
+
+server.tool(
+  "get_bhava_chalit",
+  "Get Bhava Chalit chart: actual house positions based on equal-division from house cusps (midpoint method). Shows which planets change house vs the regular Rashi chart.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_bhava_chalit", args)),
+);
+
+server.tool(
+  "get_hora",
+  "Get Planetary Hour (Hora) for any datetime and location: which planet rules the current hour, all 12 day hours, all 12 night hours, and their significance.",
+  {
+    datetime: z.string().optional().describe("ISO datetime. Defaults to now."),
+    timezone: z.string().optional().describe("IANA timezone."),
+    latitude: z
+      .number()
+      .optional()
+      .describe("Latitude for sunrise/sunset calculation."),
+    longitude: z
+      .number()
+      .optional()
+      .describe("Longitude for sunrise/sunset calculation."),
+  },
+  async (args) => jsonContent(await callBridge("get_hora", args)),
+);
+
+server.tool(
+  "get_sudarshana_chakra",
+  "Get Sudarshana Chakra: triple-layer chart analysis from Lagna, Moon, and Sun simultaneously — identifies consistently strong/afflicted planets and the current Sudarshana year.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_sudarshana_chakra", args)),
+);
+
+server.tool(
+  "get_ashtottari_dasha",
+  "Get Ashtottari Dasha (108-year, 8-planet cycle: Sun, Moon, Mars, Mercury, Saturn, Jupiter, Rahu, Venus) with mahadashas and antardashas.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_ashtottari_dasha", args)),
+);
+
+server.tool(
+  "get_sookshma_dasha",
+  "Get current Sookshma Dasha (4th level of Vimshottari: MD\u2192AD\u2192PD\u2192SD) and upcoming 5 Sookshma periods.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_sookshma_dasha", args)),
+);
+
+server.tool(
+  "get_prana_dasha",
+  "Get current Prana Dasha (5th and finest level of Vimshottari: MD\u2192AD\u2192PD\u2192SD\u2192PRD) and upcoming 5 Prana periods.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_prana_dasha", args)),
+);
+
+server.tool(
+  "get_char_dasha",
+  "Get Char Dasha (Jaimini): sign-based dasha starting from Atmakaraka's sign with mahadashas and antardashas for all 12 signs.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_char_dasha", args)),
+);
+
+server.tool(
+  "get_narayana_dasha",
+  "Get Narayana Dasha (Jaimini): sign-based dasha for worldly events, starting from Lagna sign.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_narayana_dasha", args)),
+);
+
+server.tool(
+  "get_tajaka",
+  "Get Tajaka analysis for Varshaphal: Muntha position, Munthesh, and Tajaka Yogas (Ithasala, Ishrafa, Mutthasila, Nakta, Yamaya, Duphali Kuttha, Tambira).",
+  {
+    ...standardBirthInput,
+    year_of_life: z
+      .number()
+      .int()
+      .describe("Which year's Varshaphal to analyze, e.g. 26."),
+    query_latitude: z
+      .number()
+      .optional()
+      .describe("Current location latitude."),
+    query_longitude: z
+      .number()
+      .optional()
+      .describe("Current location longitude."),
+    query_timezone: z
+      .string()
+      .optional()
+      .describe("Current location timezone."),
+  },
+  async (args) => jsonContent(await callBridge("get_tajaka", args)),
+);
+
+server.tool(
+  "get_nabhasha_yogas",
+  "Get Nabhasha Yogas: special yogas based on overall planetary distribution — Ashrayas (Rajju/Musala/Nala), Dala (Mala/Sarpa), and Akriti (Gada, Kamala, Vapi, etc.).",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_nabhasha_yogas", args)),
+);
+
+server.tool(
+  "get_arishta",
+  "Get Arishta Yogas: longevity assessment (Balarishta conditions, Pindayu longevity indicator, 8th house analysis) with disclaimer that this is one of many tools.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_arishta", args)),
+);
+
+server.tool(
+  "get_lunar_return",
+  "Get Lunar Return (Chandraphal): the chart for when the Moon returns to its natal position — computed for a specific year and month.",
+  {
+    ...standardBirthInput,
+    target_year: z
+      .number()
+      .int()
+      .describe("Year for which to find the Lunar Return, e.g. 2026."),
+    target_month: z
+      .number()
+      .int()
+      .min(1)
+      .max(12)
+      .describe("Month (1-12) for which to find the Lunar Return."),
+    query_latitude: z
+      .number()
+      .optional()
+      .describe("Current location latitude."),
+    query_longitude: z
+      .number()
+      .optional()
+      .describe("Current location longitude."),
+    query_timezone: z
+      .string()
+      .optional()
+      .describe("Current location timezone."),
+  },
+  async (args) => jsonContent(await callBridge("get_lunar_return", args)),
+);
+
+server.tool(
+  "get_prasna",
+  "Get Prasna (Horary/Question) chart: the birth chart for the exact moment a question is asked, with key Prasna indicators and general reading.",
+  {
+    datetime: z
+      .string()
+      .optional()
+      .describe("ISO datetime of the question. Defaults to now."),
+    timezone: z.string().optional().describe("IANA timezone."),
+    latitude: z
+      .number()
+      .optional()
+      .describe("Location latitude where question is asked."),
+    longitude: z
+      .number()
+      .optional()
+      .describe("Location longitude where question is asked."),
+    question: z
+      .string()
+      .optional()
+      .describe("The question being asked (for context in the reading)."),
+  },
+  async (args) => jsonContent(await callBridge("get_prasna", args)),
+);
+
+server.tool(
+  "get_kalachakra_dasha",
+  "Get Kalachakra Dasha: the 9-group, 112-year sign-based dasha system — one of the most complex and powerful dasha systems in Vedic astrology. Returns mahadashas (sign-based) and antardashas for the full cycle.",
+  standardBirthInput,
+  async (args) => jsonContent(await callBridge("get_kalachakra_dasha", args)),
+);
+
+server.tool(
+  "get_kurmachakra",
+  "Get Kurmachakra (Tortoise Wheel) directional analysis: maps the 27 Nakshatras to 8 cardinal directions + Centre. Returns auspicious/inauspicious directions for travel, construction, and marriage based on birth nakshatra (Janma Nakshatra). Optionally takes current_moon_nakshatra for daily direction guidance.",
+  {
+    ...standardBirthInput,
+    current_moon_nakshatra: z
+      .string()
+      .optional()
+      .describe(
+        "Current Moon nakshatra name, e.g. 'Rohini'. If given, includes daily auspicious/avoid directions.",
+      ),
+    event_type: z
+      .enum(["travel", "construction", "marriage", "general"])
+      .optional()
+      .describe(
+        "Type of event for tailored recommendations. Defaults to 'travel'.",
+      ),
+  },
+  async (args) => jsonContent(await callBridge("get_kurmachakra", args)),
+);
+
+server.tool(
+  "get_travel_direction_score",
+  "Score a specific intended travel direction (e.g. 'North', 'South-East') for auspiciousness using Kurmachakra rules. Returns a 0-100 score, grade (Excellent/Good/Caution/Avoid), warnings and positives considering birth nakshatra, current Moon nakshatra, and weekday direction restrictions.",
+  {
+    ...standardBirthInput,
+    intended_direction: z
+      .string()
+      .describe(
+        "Direction of intended travel, e.g. 'North', 'South', 'East', 'West', 'North-East', 'South-East', 'North-West', 'South-West'.",
+      ),
+    current_moon_nakshatra: z
+      .string()
+      .optional()
+      .describe("Current Moon nakshatra name for daily direction guidance."),
+    weekday: z
+      .enum([
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday",
+      ])
+      .optional()
+      .describe("Day of travel for weekday-direction restriction check."),
+  },
+  async (args) =>
+    jsonContent(await callBridge("get_travel_direction_score", args)),
+);
+
+server.tool(
+  "get_full_kurmachakra_chart",
+  "Return the full Kurmachakra reference chart: all 9 directions with their Sanskrit names, associated nakshatras, general nature, weekday-avoid rules, and travel guidelines. No birth data needed.",
+  {},
+  async (args) =>
+    jsonContent(await callBridge("get_full_kurmachakra_chart", args)),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);