jyotish-mcp

A Vedic astrology (Jyotish) MCP server for Claude. Precise Swiss-Ephemeris calculations — birth chart, divisional charts, Vimshottari dashas, transits, Ashtakavarga — exposed as tools so the model interprets real data instead of inventing planetary positions.

LLMs are good at interpretation and bad at ephemeris arithmetic: ask any chatbot for a chart and it will confidently hallucinate degrees, nakshatras and dasha dates. This server closes that gap.

Try it (no installation)

Add it in Claude: Settings → Connectors → Add custom connector

https://jyotish-mcp-h6px.onrender.com/mcp

Then just ask, in any language:

Analyse my chart: 15 August 1975, 06:30, Delhi

Claude resolves the city, applies the historically correct timezone, computes everything and writes the reading. (Free hosting tier — the first request after idle time may take ~50 s to wake up.)

Tools

Tool	What it returns
jyotish_find_place	Coordinates + IANA timezone for a city (offline database)
jyotish_compute_chart	D1 + D9: ascendant, 9 grahas, nakshatras & padas, dignity, vargottama, retrogradation, five-fold relationship with dispositor, Jaimini karakas, yogas (Mahapurusha, Gajakesari, yogakaraka, neecha bhanga, Kemadruma)
jyotish_vimshottari_dasha	Maha / antar / pratyantar dashas, active period for any date
jyotish_current_transits	Transit positions by house from lagna and Moon, Sade Sati phase, Saturn return
jyotish_ashtakavarga	BAV per planet + SAV per sign and per house
jyotish_divisional_chart	D2, D3, D7, D9, D10, D12

Two prompts are included: jyotish_full_analysis and jyotish_short_reading. Presentation rules are embedded in the tool descriptions, so readings come out as prose with every term explained — not as a data dump.

Conventions & accuracy

Sidereal zodiac, Lahiri ayanamsa · whole-sign houses · true nodes · Swiss Ephemeris (Moshier model, no data files needed).

Verified against professional Jyotish software on independent charts: planetary positions match to arc-seconds, dasha boundaries to the day, Ashtakavarga bindu for bindu (SAV always sums to 337 — a built-in sanity check).

Historical timezones come from the IANA database, so Soviet decree/summer time and similar rules are applied automatically — the single most common source of wrong charts.

Self-hosting

Remote (Docker / Render / any PaaS):

docker build -t jyotish-mcp . && docker run -p 8000:8000 jyotish-mcp
# endpoint: http://localhost:8000/mcp

Local (stdio, Claude Desktop): pip install -r requirements.txt && python server.py — then add it to claude_desktop_config.json. See DEPLOY.md.

Limitations

Shad-bala is not implemented. Rahu/Ketu are excluded from the planetary relationship calculation (traditions differ). Divisional charts are limited to the six listed. The public endpoint has no authentication — anyone with the URL can use it; no birth data is stored or logged (see PRIVACY.md).

Charts with an ascendant in the first or last degrees of a sign are sensitive to birth-time accuracy; the server flags this so the model can warn the user.

Disclaimer

This is an interpretation within the Jyotish tradition, not a scientific forecast. Nothing here should be used as medical, legal or financial advice.

License

MIT

---

По-русски

MCP-сервер для ведической астрологии: считает карту рождения, дроби, периоды Вимшоттари, транзиты и аштакаваргу по швейцарским эфемеридам, а Claude делает интерпретацию. Айанамша Лахири, дома whole sign, истинные узлы.

Подключение без установки: Settings → Connectors → Add custom connector и адрес https://jyotish-mcp-h6px.onrender.com/mcp. Дальше достаточно написать в чат: «Разбери карту: 15 августа 1975, 06:30, Дели» — город, исторический часовой пояс и все расчёты подставятся сами.

Точность сверена с профессиональным джйотиш-софтом на независимых картах: позиции до угловых секунд, даты периодов день в день, аштакаварга бинду в бинду.

Разбор — интерпретация в рамках традиции, а не научный прогноз.