Advanced techniques

Speculative Intraday KP Pattern Windows (personal pattern lens)

get_speculative_intraday

Minute-by-minute scan of a target trading day finding personal-chart windows where (a) Lagna sub-lord signifies any of the KP speculation houses [2, 5, 11], (b) Moon's sub-lord is clear of [6, 8, 12] problem houses, and (c) no Saturn/Jupiter retrograde invalidation. Per-window: HH:MM bands, lagna sub-lord, speculative coverage, moon clearance, retrograde flags, score 0-100. Day label: STRONG_FAVORABLE / WEAK_FAVORABLE / NEUTRAL / UNFAVORABLE relative to the native's personal chart. THIS IS PERSONAL PATTERN MATCHING, NOT FINANCIAL ADVICE OR BUY/SELL SIGNALS; tool output must never be presented as a market call, trade recommendation, or alpha signal. Defaults to NSE hours (09:00-15:30 IST) at Mumbai; override via trading_*_utc + trading_lat/lon.

Parameters

Name	Type	Required	Description
birth_datetime	string	Yes	Birth date and time in ISO 8601 format (e.g., "1990-05-15T14:30:00").
latitude	number	Yes	Birth location latitude. Range: -90 to 90.
longitude	number	Yes	Birth location longitude. Range: -180 to 180.
utc_offset_minutes	number	Yes	UTC offset in minutes (e.g., 330 for IST, -300 for EST).
ayanamsa	enum: kp \| lahiri \| raman \| true_chitra	No	Ayanamsa system. Defaults to kp.
trading_date	string	Yes	Trading day (ISO date 'YYYY-MM-DD' or full datetime)
trading_start_utc	string	No	UTC HH:MM (default '03:30' = 09:00 IST)
trading_end_utc	string	No	UTC HH:MM (default '10:00' = 15:30 IST)
trading_latitude	number	No	Default 19.0760 (Mumbai)
trading_longitude	number	No	Default 72.8777 (Mumbai)

Example call

Send the request as a standard MCP tools/call:

POST https://mcp.lumin.guru/mcp
Content-Type: application/json

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

Engine endpoint

This tool delegates to the kp-engine endpoint:

POST /v1/kp/speculative-intraday

The engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.

Birth data

This tool requires birth data. If you have already called set_birth_profile in the same conversation, the MCP server injects those fields automatically and you can omit them from the call.