vedicproof
vedic proof · computation

Guna Milan API

What is a Guna Milan API?

A Guna Milan API computes the traditional match score between two people from their Moon positions. Thirty-six gunas are distributed across eight kootas; the API returns the total, the individual koota scores, and both Moon nakshatras, so the result can be explained rather than merely displayed.

Request

Tools are called over MCP, so an assistant connected to https://vedicproof.com/mcp invokes check_compatibility itself. The arguments it sends are:

tool · check_compatibility
{
  "boy": {
    "date_of_birth": "1992-06-11",
    "time_of_birth": "14:05",
    "city": "Pune",
    "country": "India"
  },
  "girl": {
    "date_of_birth": "1994-01-19",
    "time_of_birth": "05:22",
    "city": "Kochi",
    "country": "India"
  }
}

Response

Every response carries a plain-language summary string plus structured data, and states the engine and ayanamsa it used. Abridged here for length.

result · json
{
  "total": 23,
  "boy": { "moon_nakshatra": "Chitra", "moon_rasi": "Kanya" },
  "girl": { "moon_nakshatra": "Shatabhisha", "moon_rasi": "Kumbha" },
  "kootas": [ /* eight entries with score and maximum */ ]
}

How is this calculated and verified?

These are the pinned parameters that affect this computation. The full disclosure, and the golden-chart corpus, live on /proof.

AyanamsaLahiri (Chitrapaksha), mean
Single supported system today, computed as a polynomial in Julian centuries from J2000 rather than read from a table. True-Chitra, KP-Newcomb and Raman are not offered; that is a limitation, not a default we are hiding.
Ephemeris source and versionBuilt-in analytic series - not Swiss Ephemeris
Sun from a truncated VSOP-style series, Moon from truncated ELP2000 terms, and Mercury through Saturn from JPL Keplerian elements. Accuracy is arc-minutes, not arc-seconds: a few arc-minutes for the Sun and Moon, up to roughly a tenth of a degree for the outer grahas. That is fine for rasi, nakshatra, pada, dasha and koota output and is not fine for arc-second work. Every API response carries the engine note stating this.

Common questions

Why do two sites give different guna totals?
Because a different ayanamsa or a different rounding rule moves a Moon across a nakshatra boundary, and the koota tables key on the nakshatra. Both of those parameters are published here.
Can I match without knowing the boy's birth place?
Place affects the Moon only through the time conversion, so an approximate place in the right timezone still yields the correct nakshatra in most cases.
Is the scoring configurable?
No. The standard Ashta Kuta weights are used and published; a configurable variant would make scores incomparable between calls.

Connect this to Claude or ChatGPT with one URL: https://vedicproof.com/mcp. First 14 days unlimited and free, then $1.99/month.

claude setup →chatgpt setup →pricing →

Related computations

all computations in docs →