Skip to main content
Glama

AstroNest — Vedic Astrology Readings

Guna Milan (36-point Aṣṭakūṭa) and Manglik

get_guna_milan
Read-onlyIdempotent

Use this when the user asks for the guna milan / kundli matching score (out of 36), or whether either person is Manglik. The classical Aṣṭakūṭa match for a pair (all eight kūṭas, with the Bhakoot and Nāḍī doṣas) and Manglik for both charts reckoned from the lagna, the Moon and Venus, with mutual cancellation. The same engine as /v1/compatibility, without the full reading: the score is one input, and /v1/compatibility reads each chart's marital promise, timing and doṣas on top of it. Deterministic, no language model. Cost: 2 credits per call (only successful calls are charged; a sandbox key is free and returns a fixed sample). Deterministic: the same input always gives the same answer. Example arguments: {"a":{"date":"1990-05-12","time":"14:35","timezone":"Asia/Kolkata","latitude":28.6139,"longitude":77.209,"name":"A"},"b":{"date":"1991-11-03","time":"06:10","timezone":"Asia/Kolkata","latitude":19.076,"longitude":72.8777,"name":"B"}}

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "a": "<a>",
      "b": "<b>"
    },
    "name": "get_guna_milan"
  }
}

Input Schema

NameRequiredDescriptionDefault
aYesFirst partner: birth data plus optional name and gender.
bYesSecond partner: birth data plus optional name and gender.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / a / type
      Added value: +"object"
    • addedInput schema / properties / b / type
      Added value: +"object"
  2. Changed2 schema fields changed
    • changedOutput schema / $defs / GunaMilanResponse / allOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/Envelope"
      -  },
      -  {
      -    "properties": {
      -      "gunaMilan": {
      -        "description": "Aṣṭakūṭa (36-point) matching.",
      -        "properties": {
      -          "bhakootDosha": {
      -            "$ref": "#/$defs/Dosha"
      -          },
      -          "interpretation": {
      -            "type": "string"
      -          },
      -          "kutas": {
      -            "items": {
      -              "properties": {
      -                "max": {
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "note": {
      -                  "type": "string"
      -                },
      -                "score": {
      -                  "type": "number"
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nadiDosha": {
      -            "$ref": "#/$defs/Dosha"
      -          },
      -          "totalGunas": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "manglik": {
      -        "properties": {
      -          "a": {
      -            "$ref": "#/$defs/Manglik"
      -          },
      -          "b": {
      -            "$ref": "#/$defs/Manglik"
      -          },
      -          "cancelled": {
      -            "description": "True when the doṣa is neutralised across the pair (both Manglik, or the one present is self-mitigated).",
      -            "type": "boolean"
      -          },
      -          "points": {
      -            "description": "The graded Kuja doṣa comparison (Trivedi's method, Raman's points table, reckoned from the lagna): a weighing of how evenly the two charts carry the doṣa — never a cancellation. variation = |A − B| ÷ the smaller total (null when one chart carries none and the other some); balanced = variation ≤ 0.25 (Raman). Symmetric: no gendered threshold.",
      -            "nullable": true,
      -            "properties": {
      -              "balanced": {
      -                "type": "boolean"
      -              },
      -              "heavier": {
      -                "enum": [
      -                  "A",
      -                  "B"
      -                ],
      -                "nullable": true,
      -                "type": "string"
      -              },
      -              "note": {
      -                "type": "string"
      -              },
      -              "variation": {
      -                "example": 0.5,
      -                "nullable": true,
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "pointsTotals": {
      -            "description": "Each chart's Kuja points total (lagna reckoning).",
      -            "nullable": true,
      -            "properties": {
      -              "a": {
      -                "nullable": true,
      -                "type": "number"
      -              },
      -              "b": {
      -                "nullable": true,
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "note": {
      -        "type": "string"
      -      },
      -      "partners": {
      -        "properties": {
      -          "a": {
      -            "properties": {
      -              "birth": {
      -                "type": "string"
      -              },
      -              "moonNakshatra": {
      -                "type": "string"
      -              },
      -              "moonSign": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "b": {
      -            "properties": {
      -              "birth": {
      -                "type": "string"
      -              },
      -              "moonNakshatra": {
      -                "type": "string"
      -              },
      -              "moonSign": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "roles": {
      -        "description": "Which partner was read as the groom (Varṇa is counted from the groom).",
      -        "properties": {
      -          "basis": {
      -            "type": "string"
      -          },
      -          "bride": {
      -            "enum": [
      -              "a",
      -              "b"
      -            ],
      -            "type": "string"
      -          },
      -          "groom": {
      -            "enum": [
      -              "a",
      -              "b"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "gunaMilan",
      -      "manglik"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/Envelope"
      +  },
      +  {
      +    "properties": {
      +      "gunaMilan": {
      +        "description": "Aṣṭakūṭa (36-point) matching.",
      +        "properties": {
      +          "bhakootDosha": {
      +            "$ref": "#/$defs/Dosha"
      +          },
      +          "interpretation": {
      +            "type": "string"
      +          },
      +          "kutas": {
      +            "items": {
      +              "properties": {
      +                "max": {
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "note": {
      +                  "type": "string"
      +                },
      +                "score": {
      +                  "type": "number"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nadiDosha": {
      +            "$ref": "#/$defs/Dosha"
      +          },
      +          "totalGunas": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "manglik": {
      +        "properties": {
      +          "a": {
      +            "$ref": "#/$defs/Manglik"
      +          },
      +          "b": {
      +            "$ref": "#/$defs/Manglik"
      +          },
      +          "cancelled": {
      +            "description": "True when the doṣa is neutralised across the pair (both Manglik, or the one present is self-mitigated).",
      +            "type": "boolean"
      +          },
      +          "points": {
      +            "description": "The graded Kuja doṣa comparison (a points table reckoned from the lagna): a weighing of how evenly the two charts carry the doṣa — never a cancellation. variation = |A − B| ÷ the smaller total (null when one chart carries none and the other some); balanced = variation ≤ 0.25. Symmetric: no gendered threshold.",
      +            "nullable": true,
      +            "properties": {
      +              "balanced": {
      +                "type": "boolean"
      +              },
      +              "heavier": {
      +                "enum": [
      +                  "A",
      +                  "B"
      +                ],
      +                "nullable": true,
      +                "type": "string"
      +              },
      +              "note": {
      +                "type": "string"
      +              },
      +              "variation": {
      +                "example": 0.5,
      +                "nullable": true,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "pointsTotals": {
      +            "description": "Each chart's Kuja points total (lagna reckoning).",
      +            "nullable": true,
      +            "properties": {
      +              "a": {
      +                "nullable": true,
      +                "type": "number"
      +              },
      +              "b": {
      +                "nullable": true,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "note": {
      +        "type": "string"
      +      },
      +      "partners": {
      +        "properties": {
      +          "a": {
      +            "properties": {
      +              "birth": {
      +                "type": "string"
      +              },
      +              "moonNakshatra": {
      +                "type": "string"
      +              },
      +              "moonSign": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "b": {
      +            "properties": {
      +              "birth": {
      +                "type": "string"
      +              },
      +              "moonNakshatra": {
      +                "type": "string"
      +              },
      +              "moonSign": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "roles": {
      +        "description": "Which partner was read as the groom (Varṇa is counted from the groom).",
      +        "properties": {
      +          "basis": {
      +            "type": "string"
      +          },
      +          "bride": {
      +            "enum": [
      +              "a",
      +              "b"
      +            ],
      +            "type": "string"
      +          },
      +          "groom": {
      +            "enum": [
      +              "a",
      +              "b"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "gunaMilan",
      +      "manglik"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / $defs / Manglik / description
      Previous value: -"Manglik (Kuja doṣa) for one chart, reckoned from the lagna, the Moon and Venus. A reckoning with house null was not computed — never read it as clean. Classical exceptions are applied and named: whole-chart ones in cancelledBy (Mars in Leo or Aquarius; in its own sign or exalted, or exalted in the navāṁśa; conjunct Jupiter or the Moon; Jupiter or Venus in the ascendant), per-house ones on the reckoning as exemptBy."New value: +"Manglik (Kuja doṣa) for one chart, reckoned from the lagna, the Moon and Venus. A reckoning with house null was not computed — never read it as clean. Classical exceptions are applied and named: whole-chart ones in cancelledBy (Mars in Leo or Aquarius; in its own sign or exalted, or exalted in the marriage sub-chart; conjunct Jupiter or the Moon; Jupiter or Venus in the ascendant), per-house ones on the reckoning as exemptBy."
  3. Changed1 schema field changed
    • changedOutput schema / $defs / GunaMilanResponse / allOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/Envelope"
      -  },
      -  {
      -    "properties": {
      -      "gunaMilan": {
      -        "description": "Aṣṭakūṭa (36-point) matching.",
      -        "properties": {
      -          "bhakootDosha": {
      -            "$ref": "#/$defs/Dosha"
      -          },
      -          "interpretation": {
      -            "type": "string"
      -          },
      -          "kutas": {
      -            "items": {
      -              "properties": {
      -                "max": {
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "note": {
      -                  "type": "string"
      -                },
      -                "score": {
      -                  "type": "number"
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nadiDosha": {
      -            "$ref": "#/$defs/Dosha"
      -          },
      -          "totalGunas": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "manglik": {
      -        "properties": {
      -          "a": {
      -            "$ref": "#/$defs/Manglik"
      -          },
      -          "b": {
      -            "$ref": "#/$defs/Manglik"
      -          },
      -          "cancelled": {
      -            "description": "True when the doṣa is neutralised across the pair (both Manglik, or the one present is self-mitigated).",
      -            "type": "boolean"
      -          },
      -          "reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "note": {
      -        "type": "string"
      -      },
      -      "partners": {
      -        "properties": {
      -          "a": {
      -            "properties": {
      -              "birth": {
      -                "type": "string"
      -              },
      -              "moonNakshatra": {
      -                "type": "string"
      -              },
      -              "moonSign": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "b": {
      -            "properties": {
      -              "birth": {
      -                "type": "string"
      -              },
      -              "moonNakshatra": {
      -                "type": "string"
      -              },
      -              "moonSign": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "roles": {
      -        "description": "Which partner was read as the groom (Varṇa is counted from the groom).",
      -        "properties": {
      -          "basis": {
      -            "type": "string"
      -          },
      -          "bride": {
      -            "enum": [
      -              "a",
      -              "b"
      -            ],
      -            "type": "string"
      -          },
      -          "groom": {
      -            "enum": [
      -              "a",
      -              "b"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "gunaMilan",
      -      "manglik"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/Envelope"
      +  },
      +  {
      +    "properties": {
      +      "gunaMilan": {
      +        "description": "Aṣṭakūṭa (36-point) matching.",
      +        "properties": {
      +          "bhakootDosha": {
      +            "$ref": "#/$defs/Dosha"
      +          },
      +          "interpretation": {
      +            "type": "string"
      +          },
      +          "kutas": {
      +            "items": {
      +              "properties": {
      +                "max": {
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "note": {
      +                  "type": "string"
      +                },
      +                "score": {
      +                  "type": "number"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nadiDosha": {
      +            "$ref": "#/$defs/Dosha"
      +          },
      +          "totalGunas": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "manglik": {
      +        "properties": {
      +          "a": {
      +            "$ref": "#/$defs/Manglik"
      +          },
      +          "b": {
      +            "$ref": "#/$defs/Manglik"
      +          },
      +          "cancelled": {
      +            "description": "True when the doṣa is neutralised across the pair (both Manglik, or the one present is self-mitigated).",
      +            "type": "boolean"
      +          },
      +          "points": {
      +            "description": "The graded Kuja doṣa comparison (Trivedi's method, Raman's points table, reckoned from the lagna): a weighing of how evenly the two charts carry the doṣa — never a cancellation. variation = |A − B| ÷ the smaller total (null when one chart carries none and the other some); balanced = variation ≤ 0.25 (Raman). Symmetric: no gendered threshold.",
      +            "nullable": true,
      +            "properties": {
      +              "balanced": {
      +                "type": "boolean"
      +              },
      +              "heavier": {
      +                "enum": [
      +                  "A",
      +                  "B"
      +                ],
      +                "nullable": true,
      +                "type": "string"
      +              },
      +              "note": {
      +                "type": "string"
      +              },
      +              "variation": {
      +                "example": 0.5,
      +                "nullable": true,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "pointsTotals": {
      +            "description": "Each chart's Kuja points total (lagna reckoning).",
      +            "nullable": true,
      +            "properties": {
      +              "a": {
      +                "nullable": true,
      +                "type": "number"
      +              },
      +              "b": {
      +                "nullable": true,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "note": {
      +        "type": "string"
      +      },
      +      "partners": {
      +        "properties": {
      +          "a": {
      +            "properties": {
      +              "birth": {
      +                "type": "string"
      +              },
      +              "moonNakshatra": {
      +                "type": "string"
      +              },
      +              "moonSign": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "b": {
      +            "properties": {
      +              "birth": {
      +                "type": "string"
      +              },
      +              "moonNakshatra": {
      +                "type": "string"
      +              },
      +              "moonSign": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "roles": {
      +        "description": "Which partner was read as the groom (Varṇa is counted from the groom).",
      +        "properties": {
      +          "basis": {
      +            "type": "string"
      +          },
      +          "bride": {
      +            "enum": [
      +              "a",
      +              "b"
      +            ],
      +            "type": "string"
      +          },
      +          "groom": {
      +            "enum": [
      +              "a",
      +              "b"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "gunaMilan",
      +      "manglik"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed3 schema fields changed
    • changedOutput schema / $defs / Manglik / description
      Previous value: -"Manglik (Kuja doṣa) for one chart, reckoned from the lagna, the Moon and Venus. A reckoning with house null was not computed — never read it as clean."New value: +"Manglik (Kuja doṣa) for one chart, reckoned from the lagna, the Moon and Venus. A reckoning with house null was not computed — never read it as clean. Classical exceptions are applied and named: whole-chart ones in cancelledBy (Mars in Leo or Aquarius; in its own sign or exalted, or exalted in the navāṁśa; conjunct Jupiter or the Moon; Jupiter or Venus in the ascendant), per-house ones on the reckoning as exemptBy."
    • addedOutput schema / $defs / Manglik / properties / cancelledBy
      Added value: +{
      +  "description": "Classical exceptions (parihāra) that cancel the doṣa for this chart, each with the texts that state it. When any applies, present is false — the reckonings still show where Mars stands.",
      +  "items": {
      +    "properties": {
      +      "rule": {
      +        "type": "string"
      +      },
      +      "sources": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / $defs / Manglik / properties / reckonings / items / properties / exemptBy
      Added value: +{
      +  "description": "Set when Mars stands in a doṣa house but its sign exempts it there (2nd Gemini/Virgo, 4th Aries/Scorpio, 7th Capricorn/Cancer, 8th Sagittarius/Pisces, 12th Taurus/Libra) — the stated reason, with its sources.",
      +  "type": "string"
      +}
  5. Added

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover readOnly/idempotent/non-destructive, and the description adds genuinely new operational facts: 2 credits per call, only successful calls charged, sandbox key free with fixed sample, and no language model involved. That is exactly the kind of cost/side-effect context annotations cannot express.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the trigger sentence and well ordered (purpose, scope, cost, example). Slightly redundant: determinism is asserted twice ('Deterministic, no language model' and 'Deterministic: the same input always gives the same answer'), which repeats what idempotentHint already conveys.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an output schema exists, the description need not explain return values, and it still supplies cost model, determinism, sandbox behavior and the sibling boundary. Nothing an agent needs to invoke this nested two-partner tool correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the per-field semantics come from the schema (including the useful note that omitting `time` reduces house-dependent detail). The description adds concrete example arguments that demonstrate the nested a/b shape, which is helpful for a nested-object payload, though it adds no field-level rules beyond that.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (36-point Aṣṭakūṭa guna milan score plus Manglik determination for two people) and explicitly delineates scope against the sibling get_compatibility ('the same engine as /v1/compatibility, without the full reading'). An agent can select between the two without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Opens with a direct when-to-use trigger ('when the user asks for the guna milan / kundli matching score (out of 36), or whether either person is Manglik') and names the alternative for the broader case. It also states prerequisites implicitly through the example and clarifies the output is one input to the fuller reading.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.