vedic-muhurta-mcp 🔱

MCP server for Vedic electional astrology (muhurta) — find the best moment to act.

Classical Jyotish rules: planetary horas, panchanga (tithi · nakshatra · yoga · karana · vara), Rahu Kala exclusion — computed with Swiss Ephemeris (Lahiri ayanamsa, sidereal zodiac).

Why

Every launch, deal, trip or publication has a better and a worse hour. Muhurta is the 5,000-year-old discipline of picking the right one. This server makes it queryable by any AI agent.

Tools

Tool	What it does
find_auspicious_windows	Scans N days × daylight hours → ranked windows (score + human-readable reasons) per event type: business_launch, travel, wedding, purchase, publication, healing, general
get_panchanga	Full daily Vedic calendar: tithi, nakshatra (+deity/lord), yoga, karana, vara, sunrise/sunset/noon
get_planetary_hours	24 horas with rulers, day lord, current hora
get_rahu_kala	The daily window classical rules say to avoid

30 built-in cities (Moscow → Delhi → NYC) or pass raw lat/lon.

Example

{
  "event_type": "business_launch",
  "date_from": "2026-08-25",
  "days": 7,
  "city": "moscow",
  "tz_offset_hours": 3
}

{
  "local_time": "2026-08-26 05:19–06:30",
  "score": 95,
  "ruler": "Меркурий",
  "nakshatra": "Шравана",
  "tithi": "Шукла Пакша Трайодаши",
  "reasons": [
    "hora of Меркурий favors business_launch",
    "nakshatra favorable for this event"
  ]
}

Run

pip install .
vedic-muhurta-mcp            # stdio transport (Claude Desktop / Claude Code)
VEDIC_MUHURTA_TRANSPORT=http vedic-muhurta-mcp   # streamable HTTP

Claude Desktop / claude_desktop_config.json

{
  "mcpServers": {
    "vedic-muhurta": {
      "command": "uvx",
      "args": ["vedic-muhurta-mcp"]
    }
  }
}

Accuracy & honesty

• Astronomy: Swiss Ephemeris (Moshier), Lahiri ayanamsa — sub-minute sunrise accuracy.
• Rules are a transparent simplification of classical muhurta: hora suitability ranks, curated nakshatra favorability, rikta/amavasya tithi penalties, Rahu Kala hard-exclusion. Each returned window lists its reasons so you can audit every point.
• Not a substitute for a full Jyotish consultation (no personal chart, no dasha).

The engine in production

This is the same engine that runs Nivritti — an autonomous media system publishing across 10 Telegram/VK channels only during favorable muhurtas since 2025.

License

MIT