Back to Docs
query_transits
coreComputes a planetary transit overlay for a natal chart over a specified date range. Returns current planetary positions, gochara (house-wise transit effects), Sade Sati status, active dasha period, and Ashtakavarga transit quality.
When to use
For timing analysis, annual reviews, and predictive questions. Use after cast_chart to add a temporal transit layer.
When NOT to use
For static chart interpretation (use cast_chart) or electional window finding (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"
]
},
"locale": {
"type": "string",
"enum": [
"en",
"hi"
],
"default": "en"
}
},
"required": [
"chart",
"date_range"
]
}Output
Transit overlay containing: transit_positions (rashi, degree per graha), gochara (natal_house, effect, strength per planet), active_dasha (maha and antar dasha rulers with end dates), sade_sati (active, phase), and bilingual summary.
Example Request
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "query_transits",
"arguments": {
"chart": {
"session_key": "session_001"
},
"date_range": {
"start": "2026-04-09",
"end": "2026-10-09"
},
"locale": "en"
}
}
}Example Response
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [
{
"type": "resource",
"resource": {
"uri": "kundalimcp://transits/ghi789",
"mimeType": "application/json",
"text": "{\"gochara\":[{\"graha\":\"Guru\",\"natal_house\":9,\"effect\":\"favourable\",\"strength\":\"high\"}],\"sade_sati\":{\"active\":false},\"active_dasha\":{\"maha_dasha\":{\"graha\":\"Guru\",\"end_date\":\"2031-03-10\"}}}"
}
}
]
}
}