Back to Docs
explain
analysisReturns the full IDL/CIL provenance chain for a specific interpretive claim — which rules fired, which IDL facts were inputs, which CIL weights were applied, and which schools dispute the conclusion. Designed for practitioner transparency and agent reasoning traces.
When to use
When you need to justify a specific yoga qualification, dosha assessment, or dignity evaluation. Supports practitioner review and conflict resolution.
When NOT to use
For high-level narratives (use generate_narrative) or chart computation (use cast_chart).
Input Schema
{
"type": "object",
"properties": {
"chart": {
"type": "object",
"description": "The chart — session_key or inline chart_artifact.",
"properties": {
"session_key": {
"type": "string"
},
"chart_artifact": {
"type": "object"
}
}
},
"claim_id": {
"type": "string",
"description": "The claim to explain (e.g. 'yoga_gajakesari_001', 'dignity_saturn_exalted')"
},
"locale": {
"type": "string",
"enum": [
"en",
"hi"
],
"default": "en"
},
"school": {
"type": "string",
"enum": [
"parashari",
"jaimini",
"kp"
],
"description": "School context for explanation (defaults to the chart's school)."
}
},
"required": [
"chart",
"claim_id"
]
}Output
Explanation with: claim_id, claim_type, idl_facts[], asp_rules_fired[], cil_weights[], final_score, is_active, provenance_chain[], and disputed_by_schools[].
Example Request
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "explain",
"arguments": {
"chart": {
"session_key": "session_001"
},
"claim_id": "yoga_gajakesari_001",
"locale": "en"
}
}
}Example Response
{
"jsonrpc": "2.0",
"id": 7,
"result": {
"content": [
{
"type": "resource",
"resource": {
"uri": "kundalimcp://explain/pqr678",
"mimeType": "application/json",
"text": "{\"claim_id\":\"yoga_gajakesari_001\",\"idl_facts\":[{\"fact\":\"jupiter_house\",\"value\":\"9\"},{\"fact\":\"angular_separation\",\"value\":\"6\"}],\"asp_rules_fired\":[{\"rule_id\":\"gajakesari_kendra_check\",\"result\":\"satisfied\"}],\"final_score\":0.87,\"is_active\":true,\"disputed_by_schools\":[]}"
}
}
]
}
}