Skip to content
docs
UseBuildChangelog
Open Lumin
Changelog

What changed in Lumin

Material changes to the Lumin MCP server, engine, and tool surface. Each change is tagged for everyday users, developers, or both. Internal refactors that do not affect the protocol or schemas are not listed.

v8.1.0

2026-10-30Latest

A birth time read once, and horary gates named by school

Five correctness fixes and two additive fields. A birth time with a zone suffix is read once, a mixed promise is undecided in every voice, and a horary the Moon gate withholds now carries KSK's own judgement beside it.

  • A birth_datetime ending in +hh:mm had its offset taken off twice. A suffix that agrees with the offset is now stripped, and one that disagrees is refused, naming both.
  • MIXED_ACTIVE reads as undecided everywhere, including event timing v1 and the agent's prompt, never as promised or a settled sequence.
  • The horary Moon withhold is labelled as a successor's gate. The horary, career and medical routes add gateReadings, and career and medical add judgedAsGiven, KSK's judgement of the same chart.
  • get_yoga_karaka reads BPHS ch. 34 lagna by lagna, and an unsourced 0.67 house-lord promotion leaves the CSL verdict (2 of 3,744 verdicts in the spread move).
  • get_annotated_dasha and get_transit_timing_hierarchy judge at the moment the call names, not the server's clock.
Full release notes

v8.0.0

2026-10-21

Step tools, a sharper sky, and one moment of judgement

63 new step tools and 12 renamed panels, 312 in total. The Moon and planets now sit within a fraction of an arcsecond of JPL, horary tools take one moment of judgement, and event timing reads the promise the way analyze_natal_promise does.

  • The Moon now follows ELP/MPP02 (0.154 arcseconds from JPL DE441, was 5.71) and the planets VSOP2013 (0.09, was 0.40). A position on a sub boundary can change its sub lord.
  • Large tools that bundled several calculations are split into 63 step tools, one calculation each. Twelve panels are renamed, and their old names work for this release.
  • Every horary tool takes judgement_datetime and its place under one name, set_birth_profile pins the instant a reading judges at, and the ruling planets say when they next change.
  • find_event_timing_v2 shares analyze_natal_promise's promise gate: a mixed promise is no longer called promised, and isPromised changes meaning to match.
  • Offsets are read for the birth date, a date without a zone is UTC and says so, and the plan asks first for a horary number or a second chart the question does not give.
Full release notes

v7.0.0

2026-09-28

Every method stated, and KP timing corrected

18 new tools, 237 in total. A full audit of KP, Parashari, Jaimini and Tajik corrected dasha dates, ruling planets and dozens of classical rules, and where methods differ each one ships with its methodology note. Many verdicts and dates move.

  • Vimshottari dasha dates now start at the true birth instant, the first mahadasha is no longer divided nine ways, and the ruling-planet day runs sunrise to sunrise.
  • Horary ruling planets follow KSK (the Ascendant at the moment of judgement), and fruitful significators use the ruling planets of that moment.
  • Where sources or schools disagree, every reading ships side by side with its methodology note, source class and locus. Nothing is picked silently.
  • Parashari rules were checked verse by verse in two editions of BPHS: ashtakavarga, D-60, Ashta Koota, Raja and Dhana yogas, Ashtottari, Dwisaptati, special aspects and Bhava bala.
  • Jaimini Chara dasha ships one timeline per lineage, and the Tajik mudda dasha, annual return and yogas follow the Tajika Neelakanthi.
  • 18 new tools, 237 in total, including birth-time spread, Kalachakra dasha, the KP school spread and Parashari graha drishti.
Full release notes

v6.0.0

2026-09-19

Measured against the sky, and every rule carries its page

18 new tools, 219 in total. The astronomy is checked against JPL Horizons and Swiss Ephemeris, and every response names its rule. Some positions and verdicts move.

  • The planets, the Moon, the nodes and the cusps are checked against JPL Horizons and Swiss Ephemeris, the planets to under half an arcsecond. A position within a few arcseconds of a sub boundary can change lord.
  • True Chitra is computed from Spica. It returned Lahiri's value before.
  • The ayanamsa is a reported dimension: get_frame_spread and get_paradigm_panel say which positions and which verdicts move with the frame.
  • Verdicts follow the rules the books state. 16 event rows were corrected from the corpus and 12% of verdicts moved. Every response names the rule it applied and where it comes from.
  • 18 new tools, 219 in total, across KP, Parashari, Jaimini and Tajik.
  • A developer portal, call packs at any amount, MCP protocol 2026-07-28, and plugin 0.7.0 with four writing registers.
Full release notes

v5.6.0

2026-08-16

Read for more than one person

The plugin held one birth chart. It now holds as many as you need, and names the chart it read.

  • For users
    • Save a chart per person. Ask by name. Your existing chart stays the default.
    • Every reading names the chart it used in its first line, with the birth moment and coordinates.
    • With several charts saved, a question that names nobody gets asked which one. No default, no guessing.
  • For usersFor developers

    A chart cannot live in a project folder. Plugin settings come from your user settings only, by design. Saved profiles work from any folder.

  • For usersFor developers

    Significators are stricter, so readings shift. An occupant or owner delivers a house only while no other planet sits in its own star. Older readings may differ.

  • For developers

    get_significators returns a demoted block. Every occupant or owner that no longer signifies its house is listed with the planets that took over.

v5.5.0

2026-08-13

Install as a plugin, and nothing gets cut

197 tools to 198. Install Lumin into Claude Code with two commands. Long results now arrive in pages instead of being trimmed, and two tools that failed on every call return.

  • For usersFor developers

    Long results are paged, not capped. A 3 month transit scan finds 1,072 crossings. You used to get 50 of them and no way to ask for the rest. Every paged result names the exact call that fetches the next page.

  • For usersFor developers

    Two tools were too large to return and failed on every single call. Both work now. get_dasha_periods went from 116,603 characters to 12,631 once its documented default was applied, and get_horary_chart_v2 from 140,395 to 30,559.

  • For usersFor developers

    Pratyantardasha is its own tool. The 3-lock rule needs the mahadasha, antardasha and pratyantardasha lords to agree, so the third lock is where timing actually resolves.

  • For developers

    A catalog for picking the right tool. Ask for the map, then filter by family, phase or system. 41 of the 198 tools are Parashari, 6 Jaimini and 2 Tajik, so you can see which method is answering before you quote it.

  • For usersFor developers

    Install into Claude Code with two commands. You get the reading methodology, agents that take one phase at a time, and a guard that holds a reading to its call floor.

  • For usersFor developers

    Choghadiya and hora were a day out everywhere east of Greenwich. Both divide the day sunrise to sunrise, so before local sunrise they read the previous day's table. Send utc_offset_minutes and they land on the right day.

v5.4.0

2026-08-12

13 tools for picking a time

184 tools to 197. Ask when to marry, sit an exam, hold a meeting, sign a contract, or start a journey. Every window says which rule chose it.

  • For usersFor developers

    Nine tools named for the thing you are timing, so you no longer describe the event and hope. Each one knows its own house group.

  • For usersFor developers

    Four tools for anything else. Search a date range, rank dates you can actually make, list every event you can time, or time one moment across two charts.

  • For usersFor developers

    Tell it the hours you can use and the answer gets sharper. Office hours on a wedding search cut one field from 195 candidates to 72.

  • For users

    You get one moment, or three when nothing separates them, each with the reason it won. Not a list of ten to choose between.

  • For usersFor developers

    A second KP school can cross-check the same moment, off by default. The two schools agree on 26% of windows and partly agree on 68%. A disagreement is a second opinion, not a fault.

  • For users

    Timing questions route now. 'Best date for our wedding' and 'when should we hold the board meeting' both returned nothing before. 8 of 40 phrasings found no timing tool, now none do.

  • For usersFor developers

    find_auspicious_time never searched for a time. It had no date input, read only birth data, and returned the same answer on every call. It also silently dropped 76 of its own 78 event names.

  • For usersFor developers

    Transit analysis was comparing your chart against your own birth positions. It runs on every full reading, so every reading was affected. Moon transit had the same fault and returned one answer for all dates.

  • For usersFor developers

    Rahu Kaal is correct now. Sunrise was estimated from latitude alone, with no longitude and no date, so every window built on it was wrong. Yamaganda, Gulikai and Abhijit are added.

  • For usersFor developers

    Every panchang layer now says where KP stands on it. Rahu Kaal is endorsed when Rahu rules the dasha or bhukti. Yamaganda, Gulikai and Choghadiya appear nowhere in the KP texts and are labelled classical reference.

  • For usersFor developers

    The rules come from KP Readers 3, 5 and 6, cited to the page. Reader 5 carries a 20 recipe electional chapter that was unreadable in every text copy in circulation.

  • For developers

    Electional results carry no score. The KP texts never rank a moment by a number, so scoring one would be our invention, not the method. Selection is rejection, then your constraint, then ordered tests.

  • For usersFor developers

    Surgery timing now aims at recovery. The old profile ruled out houses 5 and 11, which the texts call cure and cessation of suffering.

  • For developers

    get_panchang returns the local civil date in `date`, where it used to return the UTC date. Sunrise and sunset keep their HH:MM strings and gain ISO instants.

  • For developers

    Documentation pages were missing for 6 tools and 13 more were documented with no parameters, including 4 with none at all. The generator dropped them silently and now fails loudly.

v5.3.0

2026-08-09

11 new career tools

173 tools to 184. Ask what work fits, job or business, promotion and job change timing, and what is blocking a stalled career.

v5.2.0

2026-08-08

15 new health tools

158 tools to 173. Ask about vitality, disease patterns, treatment fit, recovery timing, surgery dates, and hospitalization windows.

v5.0.0

2026-07-22

Sign in required

Breaking: the credential-free endpoint is gone. Every connection needs a Lumin account (email and a six digit code) or an API key. Tools, names, schemas, and responses are unchanged.

  • For usersFor developers

    MCP clients: point at mcp.lumin.guru/mcp and sign in when prompted. Direct API: create a key at app.lumin.guru/developer and send it as Authorization: Bearer mcp_...

v4.2.0

2026-05-28

14 new tools: cross-school verdicts and rectification

144 tools to 158. Cross-school event verdicts, birth time rectification checks, twin chart divergence, eclipse and sade sati timelines, mundane ingress charts, and a fifth ayanamsa option (khullar).

  • For usersFor developers

    14 new tools, grouped by theme.

    Verdict
    KCIL weighted verdictFour-Step Theory verdictBosmia 6-fold significatorsMulti-system verdict comparator
    Rectification
    Rule of Origin checkSub-sub-lord boundary sensitivityTwin chart divergence score
    Analytics
    Event probability engineSade sati intensity timelineEclipse sub-lord activationMundane ingress chartsStellar dasha bifurcationCuspal interlink matrixStellar aspects
  • For usersFor developers

    The headline: pass a chart and an event, get four independent verdicts and a consensus level (UNANIMOUS, STRONG, MIXED, or SPLIT).

v4.1.0

2026-05-16

4 weather prediction tools

140 tools to 144. Seasonal outlooks, two-week windows, monsoon onset, and moment forecasts, cast for a place and date. The first tools that need no birth data.

v4.0.0

2026-05-09

62 new tools + 8 composite workflows

78 tools to 140, now spanning KP, Vedic Parashari, Jaimini, and Tajik, plus 8 composite workflows that run a complete reading in one call.

v3.0.0

2026-05-02

27 new domain tools

New question types across health, marriage, career, decisions, and outcome predictions.

  • For usersFor developers

    New questions you can ask, grouped by domain.

    Health
    Oncology timingFertility windowChronic disease panelAccident windowsChild-survival riskAyurvedic constitution
    Marriage
    Spouse archetypeSeparation riskFidelity signal
    Career
    8-track classifierEducation signatureProfession description
    Decisions
    Lost or missingLitigation timelineProperty purchaseVisa documentationIntraday speculation
    Outcomes
    ElectionSportMundane events
    Specialty
    Mantra recommendationsTwin differentiation
  • For developers

    Per-tool reference pages now auto-generate at /build/reference/tools/<slug>.

v2.0.0

2026-04-01

Methodology v2 and 14 advanced techniques

Event timing and horary run on stricter v2 logic by default: predictions are more conservative but stand up to verification. 14 advanced technique tools added.

v1.0.0

2026-03-31

Public release

Initial public release of the Lumin MCP server at mcp.lumin.guru with 33 KP tools.

  • For usersFor developers

    Connect from Claude or any MCP-compatible client and ask your first KP question.

How to read this

A version with a lot in it shows a few lines here and carries the full account on its own release notes page, linked under the lines. Pages and tools that version added wear a small New badge across the docs until the next version lands.

Lumin uses a single-version model. When a tool is deprecated, it is removed from the published tool list within one minor release, and existing callers get a clear error directing them to the replacement. We do not maintain parallel v1 and v2 surfaces indefinitely.