cast_chart

core

Computes a full Vedic birth chart (kundali) from birth datetime and coordinates. Returns planetary positions, house cusps, nakshatra placements, ShadBala strengths, Vimshopak scores, Ashtakavarga, Vimshottari dasha timeline, qualified yogas, divisional chart placements, strength profiles, afflictions, and influence profiles.

When to use

The primary entry point for all chart-based analysis. Use this before calling query_transits, generate_narrative, or explain.

When NOT to use

When you need compatibility between two charts (use match_charts) or electional windows (use query_muhurtha).

Input Schema

{
  "type": "object",
  "properties": {
    "birth_datetime": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 datetime with timezone offset (e.g. 1990-06-15T06:30:00+05:30)"
    },
    "latitude": {
      "type": "number",
      "description": "Birth latitude in decimal degrees (-90 to 90)"
    },
    "longitude": {
      "type": "number",
      "description": "Birth longitude in decimal degrees (-180 to 180)"
    },
    "config": {
      "type": "object",
      "properties": {
        "ayanamsa": {
          "type": "string",
          "enum": [
            "lahiri",
            "raman",
            "krishnamurti",
            "yukteshwar"
          ],
          "default": "lahiri",
          "description": "Ayanamsa system for sidereal calculation"
        },
        "house_system": {
          "type": "string",
          "enum": [
            "whole_sign",
            "placidus",
            "equal",
            "kp"
          ],
          "default": "whole_sign",
          "description": "House division system"
        },
        "school_profile": {
          "type": "string",
          "enum": [
            "parashari",
            "jaimini",
            "kp"
          ],
          "default": "parashari",
          "description": "Jyotish school for interpretation rules"
        }
      }
    },
    "session_key": {
      "type": "string",
      "description": "Optional ephemeral cache key. If provided, the ChartArtifact is cached and can be referenced by session_key in subsequent calls."
    },
    "ttl": {
      "type": "integer",
      "description": "Cache TTL in seconds (60–3600). Default 900."
    }
  },
  "required": [
    "birth_datetime",
    "latitude",
    "longitude"
  ]
}

Output

A ChartArtifact containing: graha_positions, lagna, house_cusps, dignities, nakshatra_placements, functional_classifications, yogas (with full qualification pipeline), shadbala, vimshopak, ashtakavarga, dasha_timeline, varga_placements, strength_profiles, afflictions, influence_profiles, boundary_margins, varga_reliability, and metadata.

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cast_chart",
    "arguments": {
      "birth_datetime": "1985-09-19T06:15:00+05:30",
      "latitude": 25.3176,
      "longitude": 82.9739,
      "config": {
        "ayanamsa": "lahiri",
        "house_system": "whole_sign",
        "school_profile": "parashari"
      },
      "session_key": "session_001",
      "ttl": 900
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "resource",
        "resource": {
          "uri": "kundalimcp://chart/abc123",
          "mimeType": "application/json",
          "text": "{\"chart_hash\":\"sha256:abc123\",\"lagna\":{\"rashi\":\"Simha\",\"nakshatra\":\"Magha\",\"nakshatra_pada\":1},\"yogas\":[{\"yoga_id\":\"gajakesari\",\"is_active\":true,\"qualification\":{\"final_score\":0.87}}]}"
        }
      }
    ]
  }
}

Next: match_charts