Back to Docs
query_muhurtha
coreFinds auspicious time windows (muhurtha) for a specified activity within a date range, evaluated against 170 muhurtha rules across panchang, planetary, and yoga factors. Optionally considers the native's natal chart for personalized muhurtha selection.
When to use
For electional astrology — finding the best time for marriage, business start, travel, griha pravesh, medical procedures, or any significant event.
When NOT to use
For natal chart analysis (use cast_chart) or transit impact (use query_transits).
Input Schema
{
"type": "object",
"properties": {
"activity": {
"type": "string",
"enum": [
"marriage",
"business_start",
"travel",
"griha_pravesh",
"education",
"medical",
"general"
],
"description": "Type of activity to find auspicious timing for"
},
"date_range": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date"
},
"end": {
"type": "string",
"format": "date"
}
},
"required": [
"start",
"end"
]
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"natal_chart": {
"type": "object",
"description": "Optional natal chart (session_key or chart_artifact) for personalized muhurtha.",
"properties": {
"session_key": {
"type": "string"
},
"chart_artifact": {
"type": "object"
}
}
},
"school_profile": {
"type": "string",
"enum": [
"parashari",
"jaimini",
"kp"
],
"default": "parashari"
},
"locale": {
"type": "string",
"enum": [
"en",
"hi"
],
"default": "en"
}
},
"required": [
"activity",
"date_range",
"latitude",
"longitude"
]
}Output
Array of MuhurthaWindow objects, each with: start/end datetime, quality_score (0.0–1.0), favorable_factors[], unfavorable_factors[], rule_count (number of rules evaluated), and bilingual description.
Example Request
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "query_muhurtha",
"arguments": {
"activity": "marriage",
"date_range": {
"start": "2026-11-01",
"end": "2026-11-30"
},
"latitude": 28.6139,
"longitude": 77.209,
"school_profile": "parashari"
}
}
}Example Response
{
"jsonrpc": "2.0",
"id": 5,
"result": {
"content": [
{
"type": "resource",
"resource": {
"uri": "kundalimcp://muhurtha/jkl012",
"mimeType": "application/json",
"text": "{\"windows\":[{\"start\":\"2026-11-07T09:30:00+05:30\",\"end\":\"2026-11-07T12:45:00+05:30\",\"quality_score\":0.91,\"favorable_factors\":[\"Shukla Paksha\",\"Rohini Nakshatra\",\"Jupiter aspecting 7th\"],\"rule_count\":170}]}"
}
}
]
}
}