# Jyotish MCP

> Deterministic Vedic astrology (Jyotish) tools for AI agents. Birth-chart facts,
> Hindu panchang with Rahu Kaal and Choghadiya windows, and Ashtakoota
> compatibility — computed from an ephemeris-backed engine, not generated prose.
> Free, no authentication.

## MCP

- Endpoint: `https://jyotish-mcp-production.up.railway.app/mcp`
- Transport: Streamable HTTP
- Authentication: none
- Discovery: `https://jyotish-mcp-production.up.railway.app/.well-known/mcp.json`
- Health: `https://jyotish-mcp-production.up.railway.app/health`

## Tools

### get_chart_facts
Vedic chart facts from birth data: lagna, Moon sign and nakshatra, current dasha,
planets in houses, house lords, dignities, combustions, divisional ascendants,
Sade Sati standing, yogas with classical-text citations, dasha timeline.

### get_panchang
Hindu calendar day for a location and date: tithi, paksha, nakshatra, yoga,
karana, vara and its lord, sunrise/sunset, plus **Rahu Kaal, Yamaganda, Gulika
Kaal** and the full **Choghadiya** day/night windows.

### guna_milan
Ashtakoota compatibility between two people, 36 points across varna, vashya, tara,
yoni, graha_maitri, gana, bhakoot and nadi. Moon nakshatra and rashi are computed
from each native's birth data — the caller does not supply them. Every koota
returns its score, its maximum, and a plain-language reason.

### ask_jyotish
Grounded answer to an astrology question, computed from the chart through the same
accuracy-gated path as the retail endpoint.


<!-- ARGUMENT-REFERENCE:BEGIN (generated — do not hand-edit) -->

## Argument reference

Generated from the live server's own schemas. `required` is enforced: a call
missing any of these returns an `invalid_params` error naming the field.

### get_chart_facts
required: `dob, tob, lat, lng, tz`

| argument | type | notes |
|---|---|---|
| `dob` | string | Birth date, YYYY-MM-DD. **(required)** |
| `tob` | string | Birth time, HH:MM (24h). **(required)** |
| `lat` | number | Birth latitude, -90 to 90. **(required)** |
| `lng` | number | Birth longitude, -180 to 180. **(required)** |
| `tz` | number or string | UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata). **(required)** |

```bash
curl -s https://jyotish-mcp-production.up.railway.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_chart_facts", "arguments": {"dob": "1995-06-14", "tob": "07:30", "lat": 26.9124, "lng": 75.7873, "tz": "Asia/Kolkata"}}}'
```

### ask_jyotish
required: `question, birth_data`

| argument | type | notes |
|---|---|---|
| `question` | string | The question to answer from the chart. **(required)** |
| `birth_data` | object |  **(required)** |
| `lang` | string |  |

```bash
curl -s https://jyotish-mcp-production.up.railway.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "ask_jyotish", "arguments": {"question": "What does my chart say about career timing?", "birth_data": ""}}}'
```

### guna_milan
required: `person_a, person_b`

| argument | type | notes |
|---|---|---|
| `person_a` | object | First native's birth data. **(required)** |
| `person_b` | object | Second native's birth data. **(required)** |

```bash
curl -s https://jyotish-mcp-production.up.railway.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "guna_milan", "arguments": {"person_a": {"dob": "1995-06-14", "tob": "07:30", "lat": 26.9124, "lng": 75.7873, "tz": "Asia/Kolkata"}, "person_b": {"dob": "1992-03-02", "tob": "14:15", "lat": 19.076, "lng": 72.8777, "tz": "Asia/Kolkata"}}}}'
```

### get_panchang
required: `lat, lng, tz`

| argument | type | notes |
|---|---|---|
| `lat` | number | Birth latitude, -90 to 90. **(required)** |
| `lng` | number | Birth longitude, -180 to 180. **(required)** |
| `tz` | number or string | UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata). **(required)** |
| `date` | string | YYYY-MM-DD (default: local today at the location). |

```bash
curl -s https://jyotish-mcp-production.up.railway.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_panchang", "arguments": {"lat": 26.9124, "lng": 75.7873, "tz": "Asia/Kolkata"}}}'
```
<!-- ARGUMENT-REFERENCE:END -->

## Limits

Rate limited per client with a daily cap; exceeding either returns HTTP 429.