MCP serverio.github.amarpathak/birthstar

Compute just a person's Vedic birth star (nakshatra) and core anchors. A one-shot shortcut: use this when the birth star is the whole question. If you expect follow-up que

Compute a full Vedic natal chart and cache it, returning a short handle. Call this FIRST. It returns a `chart_id` plus a small summary. Pass that chart_id to the other too

Get metadata and an inventory of what a cached chart contains. Useful for orienting before drilling in: returns the birth data and config it was computed with, the top-lev

Check the calling account's plan, remaining chart credits, and what is gated. Call this BEFORE attempting a tool that might be refused, not after. It is to subscription li

Get Ashtakavarga bindus — the point-score each sign carries, used for transit strength. Call this for "is this a good sign for Saturn to transit" or "which signs are stron

Get planetary and sign aspects — who is looking at which house. Graha drishti is the Parasari planetary aspect (everything aspects the 7th; Mars, Jupiter, Saturn and the n

Get planetary avasthas — the maturity, alertness and mood states of each graha. Baladi is the age state (infant..dead) and scales a planet's ability to deliver. Jagradadi

Calculate 36-point Ashta-Kuta Guna Milan compatibility between two charts. Evaluates all 8 classical Parashari Kutas (Varna, Vashya, Tara, Yoni animal intimacy, Graha Mait

Get the currently-running dasha periods for a cached chart. Returns the active lord at every nested level (Maha -> Antar -> Pratyantar -> Sukshma -> Prana) for each dasha

Walk the dasha tree — list periods at any level, past or future. Use this for "when does my next antardasha start", "what runs after this mahadasha", "when was I in Jupite

Get sunrise/sunset and the auspicious/inauspicious windows of the BIRTH day. Rahu kala, Yamaganda, Gulika kala, Abhijit and Brahma muhurta, plus true sunrise/sunset, day l

Audit classical Vedic doshas: Kuja Dosha (Manglik), Kaal Sarp, Gandanta, Pitre. Evaluates Mars placements from Lagna, Moon, and Venus with 8 classical cancellation excepti

Get conjunctions between the grahas and named prominent fixed stars. Returns only real conjunctions within the configured orb, plus what was scanned. An empty `conjunction

Get planetary positions for a cached chart. Args: chart_id: Handle returned by create_chart. planets: Optional list of names to fetch (e.g. ["Moon", "Saturn"])

Get the 12 houses (bhavas) for a cached chart. Args: chart_id: Handle returned by create_chart. method: "whole_sign" (default) — sign, lord, lord placement, ka

Get the Chara (Jaimini) karakas plus Karakamsa and Swamsa. The Atmakaraka — the planet at the highest degree in its sign — is the single most-used significator in Jaimini

Get the chart angles, special lagnas, Arudha padas and Bhrigu Bindu. Beyond the ascendant: MC/IC/Descendant/Vertex, the time-based special lagnas (Bhava/Hora/Ghati/Sree/In

Get Ayurdaya (longevity) estimates — EXPERIMENTAL, not for predictive use. The engine computes Pindayu and Nisargayu, but flags the whole section experimental: the classic

Calculate Chaldean Name Numerology and Vedic Date of Birth numbers. Calculates Name Number (compound + root), Birth Number (Mulank), Destiny Number (Bhagyank), ruling plan

Get the birth panchanga (the five limbs of the Vedic calendar). Returns tithi (lunar day + paksha), vara (weekday), nakshatra, yoga, and karana at the moment of birth, plu

Fetch curated high-value prompt templates and multi-tool question workflows. Call this tool whenever you want to suggest high-value questions to the user, or when the user

Get Shadbala, Bhava Bala and Ishta/Kashta phala — how strong each planet and house is. Call this for "which planet is strongest", "is Saturn strong enough", or "which hous

Get the turning points between two dates — dasha changes and slow-planet ingresses. This is the two-clocks view: the dasha sequence counted from birth (which theme is swit

Get gochara — where the planets are now relative to the natal chart. Answers "is Sade Sati running", "is Jupiter transiting well", "is today favourable". Houses are counte

Get one divisional chart (varga) from a cached chart. Args: chart_id: Handle returned by create_chart. varga: Which divisional chart, e.g. "D9" (navamsa), "D10

Get Vimsopaka bala — each planet's dignity-weighted strength across the 16 vargas. Use this to answer "which planets are strong across the divisional charts?" A planet in

Get the yogas (classical planetary combinations) present in a chart. Only yogas whose rule actually tested true are listed, each with the rule that matched. An empty list

Check whether this server is correctly configured and computing accurately. Reports the ephemeris mode actually in use, engine versions, and cache state. Call this when ch

Test how much a recorded birth time can actually be narrowed, and against what. Two modes: * **No events** — scans the uncertainty window and reports how many genui

Get usage metrics for this server session: calls, latency, errors, payload size. Per tool: call count, p50/p95/max latency, average and peak response size, and how many re