# 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

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

```json
{
  "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

```bash
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

```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](https://github.com/mrpkk) — an autonomous media system publishing across 10 Telegram/VK channels only during favorable muhurtas since 2025.

## License

MIT