Back to Docs
forecast_events
analysisIdentifies high-probability life-event windows from the natal compendium overlays — 247 natal overlays, 34 life-event overlays — cross-referenced with current dasha and transit state. Returns ranked event windows with domain tags, supporting evidence, and timing confidence.
When to use
For event-probability forecasting (career changes, health events, relationship milestones) grounded in natal compendium patterns and current planetary periods.
When NOT to use
For general dasha timeline (use forecast_dasha) or transit-only analysis (use forecast_transits).
Input Schema
{
"type": "object",
"properties": {
"chart": {
"type": "object",
"description": "The natal chart — session_key or inline chart_artifact.",
"properties": {
"session_key": {
"type": "string"
},
"chart_artifact": {
"type": "object"
}
}
},
"date_range": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date"
},
"end": {
"type": "string",
"format": "date"
}
},
"required": [
"start",
"end"
]
},
"domains": {
"type": "array",
"items": {
"type": "string",
"enum": [
"career",
"health",
"relationships",
"finance",
"education",
"spirituality",
"general"
]
},
"description": "Life domains to forecast events for. Defaults to all."
},
"school_profile": {
"type": "string",
"enum": [
"parashari",
"jaimini",
"kp"
],
"default": "parashari"
},
"locale": {
"type": "string",
"enum": [
"en",
"hi"
],
"default": "en"
}
},
"required": [
"chart",
"date_range"
]
}Output
Array of EventWindow objects, each with: start/end datetime, domain, event_type, probability_score (0.0–1.0), supporting_overlays[], dasha_confluence, and bilingual description.
Example Request
{
"jsonrpc": "2.0",
"id": 10,
"method": "tools/call",
"params": {
"name": "forecast_events",
"arguments": {
"chart": {
"session_key": "session_001"
},
"date_range": {
"start": "2026-01-01",
"end": "2027-12-31"
},
"domains": [
"career",
"relationships"
],
"school_profile": "parashari",
"locale": "en"
}
}
}Example Response
{
"jsonrpc": "2.0",
"id": 10,
"result": {
"content": [
{
"type": "resource",
"resource": {
"uri": "kundalimcp://events/forecast/bbb002",
"mimeType": "application/json",
"text": "{\"events\":[{\"start\":\"2026-08-01\",\"end\":\"2026-10-15\",\"domain\":\"career\",\"event_type\":\"career_transition\",\"probability_score\":0.74,\"supporting_overlays\":[\"10th_lord_transit_10\",\"dasha_ruler_career_activation\"]}]}"
}
}
]
}
}