forecast_transits
analysisGenerates a forward-looking transit forecast for a natal chart, identifying key planetary ingresses, station points, and dasha-transit confluences within the requested window. Returns ranked forecast windows with quality scores and domain tags (career, health, relationships, finance).
When to use
For predictive annual planning, identifying high-opportunity or high-risk windows, and multi-domain transit forecasting over months or years.
When NOT to use
For point-in-time transit snapshots (use query_transits) or electional timing for a specific event (use query_muhurtha).
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",
"general"
]
},
"description": "Life domains to forecast. 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 ForecastWindow objects, each with: start/end datetime, domain, quality_score (0.0–1.0), contributing_transits[], dasha_confluence (active maha/antar rulers), favorable_factors[], and bilingual description.
Example Request
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "forecast_transits",
"arguments": {
"chart": {
"session_key": "session_001"
},
"date_range": {
"start": "2026-01-01",
"end": "2026-12-31"
},
"domains": [
"career",
"finance"
],
"school_profile": "parashari",
"locale": "en"
}
}
}Example Response
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [
{
"type": "resource",
"resource": {
"uri": "kundalimcp://forecast/abc789",
"mimeType": "application/json",
"text": "{\"windows\":[{\"start\":\"2026-03-15\",\"end\":\"2026-05-10\",\"domain\":\"career\",\"quality_score\":0.88,\"contributing_transits\":[\"Guru entering Mithuna\",\"Shani aspecting 10th\"],\"dasha_confluence\":{\"maha\":\"Guru\",\"antar\":\"Shukra\"}}]}"
}
}
]
}
}