Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Live → Recently observed
Changed the definition of "get_chart"
⟨197 unchanged words⟩ number"},"orbDegrees":{"default":3,"description":"Orb as a ground distance in degrees of great-circle arc (1 degree = about 111 km at any latitude). Widened for an approximate birth time; no lines for an unknown one.","maximum":15,"type":"number"}}," ⟨23 unchanged words⟩
Changed the definition of "get_ephemeris_positions" and "get_ephemeris_series"
⟨28 unchanged words⟩ true); Ketu is the node + 180°. Every AstroNest chart, reading and timing endpoint uses the mean node.","enum":["Sun","Moon"," ⟨74 unchanged words⟩
⟨84 unchanged words⟩ true); Ketu is the node + 180°. Every AstroNest chart, reading and timing endpoint uses the mean node.","enum":["Sun","Moon"," ⟨220 unchanged words⟩
Added "get_prashna" and "get_techniques"; changed the definition of "get_chart" and "resolve_timing" (19 tools before, 21 now)
⟨9 unchanged words⟩ {"type":"number"},"nakshatra":{"description":"Nakṣatra of the sidereal ascendant.","type":["string","null"]},"pada":{"description":"Pada (1–4) of the ascendant's nakṣatra.","type":["integer","null"]},"sign":{"type":"string"}},"type ⟨40 unchanged words⟩ },"computationId":{"description":"SHA-256 of every input that changes theinputsresult (birth date, time, coordinates, timezone, frame, daśā switch and depth, divisionals): identical inputs give the same id, different requests never share one, and it never exposes the birth data."," ⟨330 unchanged words⟩ :"object"},"Planet":{"properties":{"combust":{"description":"Combustion (astaṅgata): true when the graha is within its orb of the Sun (Moon 12°, Mars 17°, Mercury 14° or 12° retrograde, Jupiter 11°, Venus 10° or 8° retrograde, Saturn 15°). null where it does not apply: the Sun, Rahu, Ketu and the outer planets. Natal chart only; divisional planets omit it.","type":["boolean","null"]},"combustion":{"description":"Present only when `combust` is true.","properties":{"deep":{"description":"Within half the orb.","type":"boolean"},"distanceFromSun":{"description":"Angular distance from the Sun, degrees.","type":"number"},"orb":{"description":"The combustion orb applied, degrees.","type":"number"}},"type":["object","null"]},
Changed the definition of "get_guna_milan"
⟨147 unchanged words⟩ self-mitigated).","type":"boolean"},"points":{"description":"The graded Kuja doṣa comparison (Trivedi's method, Raman's points table, reckoned from the lagna): a weighing of how evenly the two charts carry the doṣa — never a cancellation. variation = |A − B| ÷ the smaller total (null when one chart carries none and the other some); balanced = variation ≤ 0.25 (Raman). Symmetric: no gendered threshold.","nullable":true,"properties":{"balanced":{"type":"boolean"},"heavier":{"enum":["A","B"],"nullable":true,"type":"string"},"note":{"type":"string"},"variation":{"example":0.5,"nullable":true,"type":"number"}},"type":"object"},"pointsTotals":{"description":"Each chart's Kuja points total (lagna reckoning).","nullable":true,"properties":{"a":{"nullable":true,"type":"number"},"b":{"nullable":true,"type":"number"}},"type":"object"},"reason":{"type":["string","null" ⟨322 unchanged words⟩
Changed the definition of "get_guna_milan"
⟨257 unchanged words⟩ not computed — never read it as clean. Classical exceptions are applied and named: whole-chart ones in cancelledBy (Mars in Leo or Aquarius; in its own sign or exalted, or exalted in the navāṁśa; conjunct Jupiter or the Moon; Jupiter or Venus in the ascendant), per-house ones on the reckoning as exemptBy.","properties":{"cancelledBy":{"description":"Classical exceptions (parihāra) that cancel the doṣa for this chart, each with the texts that state it. When any applies, present is false — the reckonings still show where Mars stands.","items":{"properties":{"rule":{"type":"string"},"sources":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"mitigations":{"items":{"type":"string" ⟨8 unchanged words⟩ ,"reckonings":{"items":{"properties":{"exemptBy":{"description":"Set when Mars stands in a doṣa house but its sign exempts it there (2nd Gemini/Virgo, 4th Aries/Scorpio, 7th Capricorn/Cancer, 8th Sagittarius/Pisces, 12th Taurus/Libra) — the stated reason, with its sources.","type":"string"},"from":{"enum":["lagna","Moon ⟨65 unchanged words⟩
Changed the definition of "get_domain_timeline" and "get_life_reading"
⟨78 unchanged words⟩ :"string"},"type":"array"},"care":{"description":"Health only, in-focus periods only: the body areas the tradition links to the period and the matching check-up. Not repeated in `words`.","items":{"type":"string"},"type":"array"},"chain":{"description":"Mahādaśā / antardaśā, e.g. \"Saturn / Venus\".","type":"string"},"classical":{"description":"The classical grounds behind the period, in plain words: the chapter (mahādaśā) lord, the period lord's nakṣatra (star) lord and its full aspect, where they bear on this area. Not repeated in `words`.","items":{"type":"string"},"type":"array"},"focus":{"description":"primary: ⟨220 unchanged words⟩
⟨153 unchanged words⟩ Changed the definition of "get_domain_timeline" and "get_life_reading"
⟨45 unchanged words⟩ it on this chart, every period thatbrings itbearsintoonfocusit (past and future, with dates, ages and why that planet governs it), each marked `primary` when the area is in focus or `also` when the period only touches it, and what is in focus now and ⟨111 unchanged words⟩
⟨90 unchanged words⟩ Venus\".","type":"string"},"focus":{"description":"primary: the area is in focus (the period lord rules or occupies the area's primary house, or is its kāraka; a node acts for its sign lord). also: the period only touches the area through a wider significator. `now`, `next` and the summary use primary periods only.","enum":["primary","also"],"type":"string"},"
Added "assess_gemstone", "get_domain_timeline", "get_life_reading" and 2 more; changed the definition of "find_muhurta", "get_chart", "get_compatibility" and 11 more (14 tools before, 19 now)
AuspiciousUsewindowsthis when the user asks for an auspicious date or time (muhūrta)into do something, such as a wedding, launch, move or purchase, within a daterange.range at a given place. Scans each day in the range and ranks ⟨76 unchanged words⟩
Certificate recorded, valid to 2026-12-21
Authorization not required
Added "get_guna_milan"; changed the definition of "get_chart" and "get_dasha" (13 tools before, 14 now)
⟨33 unchanged words⟩ place and the chart's own frame relocated there. Includes the D9 and D10 divisional charts by default; ask for any of the sixteen ṣoḍaśavarga with `divisionals`. Cost: 1 credit per call (only successful ⟨37 unchanged words⟩
⟨85 unchanged words⟩ ,"longitude"],"type":"object"},"divisionals":{"default":["d9","d10"],"description":"Divisional charts (vargas) to include: any of the sixteen ṣoḍaśavarga. Default d9 (navāṁśa) and d10 (daśāṁśa); send [] for none. Each returns its ascendant and every graha's sign, degree and house within the varga, by the Parāśari formulas.","items":{"enum":["d1","d2","d3","d4","d7","d9","d10","d12","d16","d20","d24","d27","d30","d40","d45","d60"],"type":"string"},"type":"array"},"includeDasha":{"default":true,"description":"Include ⟨70 unchanged words⟩
Unknown → Live
First tool surface recorded: 13 tools (server version 1.0.0)
https://www.astronest.ai/api/developer/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 15 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨28 unchanged words⟩ true); Ketu is the node + 180°. Every AstroNest chart, reading and timing endpoint uses the mean node.","enum":["Sun","Moon"," ⟨112 unchanged words⟩
⟨84 unchanged words⟩ true); Ketu is the node + 180°. Every AstroNest chart, reading and timing endpoint uses the mean node.","enum":["Sun","Moon"," ⟨203 unchanged words⟩
⟨43 unchanged words⟩ as an answer to a decision `question`,optionally anchoredreadtoat `targetDate` (or`dateRange`.the start of `dateRange`, or today when neither is sent): the verdict, the running daśā and eventTiming are taken at that day. A malformed or pre-birth date is refused with 400 (`invalid_target_date`, `invalid_date_range`). Expect tens of seconds; set a client timeout ⟨60 unchanged words⟩
⟨94 unchanged words⟩ is about: start and end dates, YYYY-MM-DD. The verdict is read at `start`; `end` must not precede it.","properties":{"end":{"format": ⟨69 unchanged words⟩ :"Optional date the decision is about, YYYY-MM-DD. The verdict is read at this day. Takes precedence over `dateRange`.","format":"date","type":"string ⟨6 unchanged words⟩
⟨299 unchanged words⟩ :{"type":["string","null"]},"referenceDate":{"description":"The day the verdict, the daśā reading and eventTiming are anchored to: `targetDate` when sent, else `dateRange.start`, else the day of the call.","format":"date","type":"string"}},"type":"object"}]},"TimingWindow" ⟨51 unchanged words⟩
Praśna (horary): a question, a deal, or a KP number — Use this when the user asks a specific question and wants it answered from the moment of asking rather than from a birth chart — "will this deal close?", "will I recover?", "will I find what I lost?" — or when a KP astrologer gives a horary number 1–249. Send where the user is as `place`; it is never defaulted. The chart of the moment and place a question is asked, read on the classical praśna rules, no model. Always: the praśna lagna and its lord, the Moon, the house of the matter asked about, the hand-encoded classical dicta that apply (recovery from illness for a health question; recovery …
Classical techniques for a chart — Use this when the user or an astrologer asks for a specific classical computation — Ṣaḍbala, Aṣṭakavarga, Yoginī/Chara/Nārāyaṇa daśā, Varṣaphal, KP cusps, a named yoga, the birth pañcāṅga, Kuja doṣa, house lords and aspects — rather than for a reading. Pass `sections` to fetch only what is needed. The computed classical working for a chart, no model: Ṣaḍbala and bhāva bala (BPHS 27), Aṣṭakavarga with trikoṇa/ekādhipatya reduction and piṇḍas, the Aṣṭottarī, Kālacakra, Nārāyaṇa, Yoginī and Chara daśās with the periods running at `referenceDate`, the full Vimśottarī ladder, the Varṣaphal (Tājika…
⟨68 unchanged words⟩ and future with why that planet governs it,— each marked `primary` (the area is in focus) or `also` (the period only touches it) — and what is in focus now and next. ⟨125 unchanged words⟩
⟨165 unchanged words⟩ Venus\".","type":"string"},"focus":{"description":"primary: the area is in focus (the period lord rules or occupies the area's primary house, or is its kāraka; a node acts for its sign lord). also: the period only touches the area through a wider significator. `now`, `next` and the summary use primary periods only.","enum":["primary","also"],"type":"string"},"from":{"type":"string"},"lord" ⟨183 unchanged words⟩
Natal chart (kundli)NatalUsechart.this when the user wants their birth chart (kundli): ascendant, planets in signs and houses, yogas, the current planetary periods, or a divisional chart such as the navāṁśa (D9). Sidereal (Lahiri) chart: ascendant, the nine ⟨95 unchanged words⟩
⟨173 unchanged words⟩ "object"},"yogas":{"items":{"additionalProperties":true,"type$ref":"object#/$defs/Yoga"},"type":"array"}},"type" ⟨297 unchanged words⟩ }},"required":["units_charged","remaining_credits"],"type":"object"},"Yoga":{"description":"A yoga formed in this chart. AstroNest does not rank yogas: there is no strength or score, only whether it is formed and what it rests on.","properties":{"basis":{"description":"What the yoga rests on in this chart, e.g. \"Jupiter and Moon in kendra from each other\".","type":"string"},"classicalSource":{"type":["string","null"]},"englishName":{"type":"string"},"houses":{"items":{"type":"integer"},"type":"array"},"name":{"type":"string"},"planets":{"items":{"type":"string"},"type":"array"},"strength":{"deprecated":true,"description":"Always null: AstroNest does not rank yogas. Read basis instead.","enum":["strong","moderate","weak",null],"type":["string","null"]},"type":{"type":"string"}},"type":"object"}},"$ref":" ⟨3 unchanged words⟩
CompatibilityMarriageofcompatibility:twothechartsfull reading
CompatibilityUseofthis when the user asks whether twocharts.peopleComputesarebotha good match for marriage and wants the full reading, not only a score. For the fast 36-point score with Manglik alone, use get_guna_milan. Both charts read together for marriage. The 36-point Aṣṭakūṭa (guna milan) is one input: the verdict names the governing factor andreadssaysthemwhentogether.it outweighs the score. Also returned: each chart's marital promise, sustainability and happiness, progeny, Manglik reckoned from the lagna, the Moon and Venus with mutual cancellation, a joint marriage-timing window, synastry, and caveats where an uncertain birth time would change the reading. Deterministic: no language model is called. Each partnerobjectis a BirthData object plus optional `name` and ⟨61 unchanged words⟩
Vimśottarī daśā timeline (planetary periods)VimśottarīUse this when the user asks which planetary period (daśā)timeline.they are in, when it ends, or which periods are coming. The current periods include the running pratyantardaśā; send ⟨53 unchanged words⟩
AscendantUse this when you need the ascendant,MCmidheavenandor housecusps.cusps for a moment and place. Ascendant, midheaven and twelve cusps for a moment ⟨72 unchanged words⟩
AyanamsaUsevalues.this when you need an ayanamsa value (Lahiri, Raman, Krishnamurti, Fagan–Bradley) at a moment. Lahiri, Raman, Krishnamurti and Fagan–Bradley (mean, ⟨52 unchanged words⟩
PositionsUse this when you need where the Sun, Moon and planets are at amoment.moment (sidereal or tropical), not a reading. Sun, Moon, planets and lunar nodes at ⟨83 unchanged words⟩
PositionsUseoverthis when you need planetary positions across arange.range of dates, for a transit table or to find when a planet changes sign or stations. Positions from start to end (inclusive) every ⟨8 unchanged words⟩ most 1,000 points (too_many_points beyond).**Price: 1 credit per started 100 points** (aA 365-point daily table costs 4).credits. Cost: 1 credit per started 100 points ⟨40 unchanged words⟩
SunriseUse this when you need sunrise andsunset.sunset for a date and place, or where the Vedic day begins. Sunrise, sunset and the next sunrise for a ⟨74 unchanged words⟩
Forward-lookingWrittenreadinganswerforaboutawhatquestionlies ahead
Forward-lookingUsereadingthis when the user asks an open question about what lies ahead in one area of life and wants a written answer. It takes tens of seconds; for aquestion.fast, structured verdict use interpret_domain. The interpret verdict for `domain`, voiced as a ⟨86 unchanged words⟩
Lifestyle guidanceGuidance for the running daśā periods
LifestyleUseguidancethisforwhen therunninguserdaśāasksperiods.how to conduct themselves in the period they are in: what to do and what to take care with, each with its classical reason. Guidance, not prediction. Plain-language guidance cards for each running daśā level ⟨52 unchanged words⟩
GunaUseMilanthis when the user asks for the guna milan / kundli matching score (36-pointoutAṣṭakūṭaof 36),andorManglik.whether either person is Manglik. The classical Aṣṭakūṭa match for a pair (all ⟨116 unchanged words⟩
DomainReadingreadingof one life area
DomainUsereading.this when the user asks what their chart says about one area of life (career, marriage, finance, health, property, children, education, travel, legal and others) and a reproducible verdict with its reasons and sources is wanted. Prefer it to get_forecast when no written narrative is needed. Deterministic reading of one lifedomainarea: the verdict,supportingthe factors for andcautionaryagainstfactorsit, timing windows,methodwhetheragreementthe engine's own methods agree, and theweighedclassicalcorpusbooksposition.the reading draws on. Every layer is declared as present, computed_empty, not_covered or failed, so nothing is silently missing. No language model iscalled.called: the same chart always gets the same reading. Cost: 5 credits per call (only successful ⟨39 unchanged words⟩
DecisionIs this a good time? (decision timing)
DecisionUsetiming.thisLikewhenforecastthe user asks whether now, or a particular date or range, is a good time for a decisionquestionsuch as changing jobs, marrying or investing. It takes tens of seconds. The interpret verdict for `domain`, voiced by a language model as an answer to a decision `question`, optionally anchored to `targetDate` or `dateRange`. Expect tens ofseconds.seconds; set a client timeout of at least 90 s. Cost: 7 credits per call (only successful ⟨48 unchanged words⟩
Gemstone assessment — Use this when the user asks whether they should wear a particular gemstone (blue sapphire, emerald, pukhraj, a crystal), or whether a stone they wear suits their chart. Answers the prescription, not the future: which planet the stone strengthens, what that planet owns from this ascendant, whether a classical rule (a dusthāna or kendrādhipati lordship, a māraka) argues against strengthening it, and whether the reason is permanent or lasts only as long as the running period. Returns a verdict — well_founded, period_bound, no_ground, contraindicated or unrecognised — with every ground for and ag…
Life-area timeline — Use this when the user asks about one area of life — when marriage, children, career, money, property or another area is in focus, or what a given stretch of years holds for it. One life area across the whole life: the planets that govern it on this chart, every period that brings it into focus (past and future, with dates, ages and why that planet governs it), and what is in focus now and next, in plain words. Pass `window` to get only the periods that overlap a date range. It is the same reading as the whole-life reading, cut to one area, so the two never disagree. Health is read only as pe…
Whole-life reading — Use this when the user wants their life as a whole: which life areas (marriage, children, career, business, money, property, family, travel, education, spirituality, health) are in focus when, across past and future, and where life stands now. The life's chapters (each mahādaśā in plain words, with dates and ages) and eleven life areas, each with the planets that govern it on this chart, every governing period past and future with why that planet governs it, and what is in focus now and next. Past periods are included, so the reading can be tested against a life already lived; send `recorded`…
Relationship reading (non-marital) — Use this when the user asks how two people get on in a bond other than marriage — business partners, siblings, a parent and child, or friends. Reads the bond the way the classical method reads it: the houses that govern this kind of bond and their lords in each chart, the natural significators, whose planets fall in whose governing houses, and whether that reach runs both ways, plus the running periods in each chart that engage the bond. A bond meter (strong tie, workable or strained) is computed by a stated convention and returned with every point it is built from; it is not a classical scor…
Venture timing: when to commit, which business — Use this when the user asks when to start, launch, sign, borrow or expand a business, or which line of business their chart supports. A calendar of the coming months in four labels — commit (sign, open, launch), build (keep building; commit only what can be undone), guarded (low fixed cost; no lease, no borrowing) and hold (no new fixed commitments) — each window with the daśā period running and the slow transits of Saturn and Jupiter over it, and the reasons. Describe the businesses being weighed in `ventures` and each is ranked on how strongly the chart supports it and whether the coming pe…
⟨92 unchanged words⟩ "object","null"]},"divisionals":{"itemsdescription":{"additionalPropertiesThe vargas requested (default D9 and D10).":true,"typeitems":{"object$ref":"#/$defs/DivisionalChart"},"type":"array"},"domain":{ ⟨87 unchanged words⟩ "},"mahadashaEnd":{"type":"string"},"pratyantardasha":{"description":"The running pratyantardaśā.","type":["string","null"]},"pratyantardashaEnd":{"type":["string","null"]}},"type":["object","null"]},"DashaPeriod":{"properties ⟨16 unchanged words⟩ ,"planet":{"type":"string"},"pratyantardashas":{"description":"On each antardaśā when depth is 'pratyantardasha'.","items":{"$ref":"#/$defs/DashaPeriod"},"type":"array"},"start":{"type":"string"}},"type":"object"},"DivisionalChart":{"description":"One varga. Houses count whole-sign from the varga ascendant. Nakṣatra, pada and dignity are natal concepts and are null here.","properties":{"ascendant":{"properties":{"degree":{"type":"number"},"sign":{"type":"string"}},"type":"object"},"division":{"description":"D9, D10, …","type":"string"},"planets":{"items":{"properties":{"degree":{"type":"number"},"dignity":{"type":["string","null"]},"house":{"type":"integer"},"longitude":{"type":"number"},"nakshatra":{"type":["string","null"]},"pada":{"type":["integer","null"]},"planet":{"type":"string"},"retrograde":{"type":"boolean"},"sign":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"Envelope" ⟨154 unchanged words⟩
Vimśottarī daśā timeline. The current periods include the running pratyantardaśā; send depth 'pratyantardasha' for the full timeline at that level. Cost: 1 credit per call (only successful ⟨37 unchanged words⟩
⟨84 unchanged words⟩ latitude","longitude"],"type":"object"},"depth":{"default":"antardasha","description":"Timeline depth. 'pratyantardasha' nests the pratyantardaśās under each antardaśā (about ten times larger). The current periods always include the running pratyantardaśā.","enum":["antardasha","pratyantardasha"],"type":"string"}},"required":["birthData"],"type":"object"}
⟨14 unchanged words⟩ "},"mahadashaEnd":{"type":"string"},"pratyantardasha":{"description":"The running pratyantardaśā.","type":["string","null"]},"pratyantardashaEnd":{"type":["string","null"]}},"type":["object","null"]},"DashaPeriod":{"properties ⟨15 unchanged words⟩ "string"},"planet":{"type":"string"},"pratyantardashas":{"description":"On each antardaśā when depth is 'pratyantardasha'.","items":{"$ref":"#/$defs/DashaPeriod"},"type":"array"},"start":{"type":"string"} ⟨122 unchanged words⟩
Guna Milan (36-point Aṣṭakūṭa) and Manglik — Guna Milan (36-point Aṣṭakūṭa) and Manglik. The classical Aṣṭakūṭa match for a pair (all eight kūṭas, with the Bhakoot and Nāḍī doṣas) and Manglik for both charts reckoned from the lagna, the Moon and Venus, with mutual cancellation. The same engine as /v1/compatibility, without the full reading: the score is one input, and /v1/compatibility reads each chart's marital promise, timing and doṣas on top of it. Deterministic, no language model. Cost: 2 credits per call (only successful calls are charged; a sandbox key is free and returns a fixed sample). Deterministic: the same input always gives…