Back to Docs

recommend_remedies

analysis

Suggests Jyotish remedial measures (upaaya) for identified afflictions, weak grahas, or active doshas in a natal chart. Returns gemstone recommendations, mantra prescriptions, fasting protocols, and charitable acts — all school-parameterized and ranked by efficacy score.

When to use

After cast_chart, when the native seeks remedial guidance for afflictions, dosha mitigation, or graha strengthening.

When NOT to use

For timing predictions (use query_transits or forecast_transits) or chart narratives (use generate_narrative).

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"
        }
      }
    },
    "focus": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "graha_strengthening",
          "dosha_mitigation",
          "yoga_activation",
          "general"
        ]
      },
      "description": "Remedy focus areas. Defaults to general."
    },
    "school_profile": {
      "type": "string",
      "enum": [
        "parashari",
        "jaimini",
        "kp"
      ],
      "default": "parashari"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "hi"
      ],
      "default": "en"
    }
  },
  "required": [
    "chart"
  ]
}

Output

Array of RemedyRecommendation objects, each with: graha, affliction_type, remedy_type (gemstone/mantra/fasting/charity), prescription, efficacy_score (0.0–1.0), school_rationale, and bilingual description.

Example Request

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "tools/call",
  "params": {
    "name": "recommend_remedies",
    "arguments": {
      "chart": {
        "session_key": "session_001"
      },
      "focus": [
        "dosha_mitigation",
        "graha_strengthening"
      ],
      "school_profile": "parashari",
      "locale": "en"
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "content": [
      {
        "type": "resource",
        "resource": {
          "uri": "kundalimcp://remedies/xyz001",
          "mimeType": "application/json",
          "text": "{\"remedies\":[{\"graha\":\"Shani\",\"affliction_type\":\"debilitated\",\"remedy_type\":\"mantra\",\"prescription\":\"Om Sham Shanicharaya Namah — 108 repetitions on Saturdays\",\"efficacy_score\":0.82}]}"
        }
      }
    ]
  }
}