Back to Docs

generate_narrative

narrative

Generates a deterministic Tier 1 narrative for a specific life domain from a computed natal chart. Uses the Narrative Fragment Library — no LLM involved, fully reproducible. Bilingual output (en + hi). Optionally requests Tier 2/3 analytical depth.

When to use

After cast_chart, to produce human-readable domain summaries (career, relationships, health, etc.) for presentation to users.

When NOT to use

When you need provenance or rule traces for a specific claim (use explain).

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"
        }
      }
    },
    "domain": {
      "type": "string",
      "enum": [
        "general",
        "career",
        "health",
        "relationships",
        "finance",
        "education",
        "spirituality"
      ]
    },
    "tier": {
      "type": "string",
      "enum": [
        "summary",
        "detailed",
        "comprehensive"
      ],
      "default": "detailed"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "hi"
      ],
      "default": "en"
    },
    "tone": {
      "type": "string",
      "enum": [
        "professional",
        "traditional",
        "conversational"
      ],
      "default": "professional"
    }
  },
  "required": [
    "chart",
    "domain"
  ]
}

Output

Narrative response with: narrative.en, narrative.hi, coverage (full/partial), fragments_used[], edge_case_reasons[], and practitioner_review_suggested flag.

Example Request

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "generate_narrative",
    "arguments": {
      "chart": {
        "session_key": "session_001"
      },
      "domain": "career",
      "tier": "detailed",
      "locale": "en",
      "tone": "professional"
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "content": [
      {
        "type": "resource",
        "resource": {
          "uri": "kundalimcp://narrative/mno345",
          "mimeType": "application/json",
          "text": "{\"narrative\":{\"en\":\"Jupiter in the 10th house with strong Dig Bala indicates significant career potential...\",\"hi\":\"दसवें भाव में गुरु की दिग्बल शक्ति व्यावसायिक उत्कर्ष की संभावना दर्शाती है...\"},\"coverage\":\"full\",\"practitioner_review_suggested\":false}"
        }
      }
    ]
  }
}
Previous: assess_natalNext: explain