Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Multi-Session Ruling Planet Consensus (KP T17)

get_rp_consensus

When a querent asks the same question at multiple distinct moments (different times of day, different days), the significators that appear in every session's fruitful set carry the highest predictive certainty (T17). This tool takes at least 2 session moments and an event and computes the intersection of fruitful significators across sessions. Returns per-session details, ranked consensus list (planet, sessionCount, bestLevel), unanimous and near-unanimous planets, and a verdict: STRONG_UNANIMOUS / STRONG_PARTIAL / MIXED / WEAK.

Parameters

NameTypeRequiredDescription
birth_datetimestringYesBirth date and time in ISO 8601 format (e.g., "1990-05-15T14:30:00").
latitudenumberYesBirth location latitude. Range: -90 to 90.
longitudenumberYesBirth location longitude. Range: -180 to 180.
utc_offset_minutesnumberYesUTC offset in minutes (e.g., 330 for IST, -300 for EST).
ayanamsaenum: kp | kp_new | lahiri | raman | true_chitra | khullarNoAyanamsa system. Defaults to kp.
sessionsarray<object>NoAt least 2 session moments. Each carries its own datetime/offset/lat/lon (the querent may be in different places).
eventevent nameNoEvent being asked about (default: Marriage).
house_grouparray<unknown>NoOverride houses to check (skip event lookup).

Example call

Send the request as a standard MCP tools/call:

http
POST https://mcp.lumin.guru/mcp
Authorization: Bearer mcp_yourkey...
Accept: application/json, text/event-stream
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_rp_consensus",
    "arguments": {
      "birth_datetime": "1992-08-14T04:32:00",
      "latitude": 6.927,
      "longitude": 79.861,
      "utc_offset_minutes": 330,
      "ayanamsa": "kp"
    }
  }
}

Birth data

This tool requires birth data on every call. The MCP server is stateless, so calling set_birth_profile first validates the data and returns the reading plan, but it does not store anything. Repeat the same five fields here.