Metadata-Version: 2.4
Name: mcp-server-panchangam
Version: 1.0.0
Summary: MCP server for Panchangam calculations — Tithi, Nakshatra, Yoga, Muhurtas for any city
License: MIT
Keywords: panchangam,vedic,astrology,mcp,calendar
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0
Requires-Dist: pyswisseph>=2.10
Requires-Dist: pytz
Requires-Dist: geopy
Requires-Dist: timezonefinder
Requires-Dist: icalendar

# Telugu Panchangam Calendar Feeds

Subscribable Telugu Panchangam feeds for 22 cities — delivered as `.ics` files you can add to Google Calendar, Apple Calendar, or Outlook.

Every day appears as an all-day event (no calendar blocking) with full Panchangam details in the description. Special days — Ekadashi, Amavasya, Pournami, Pradosham, Sankranti — are marked with ⚡ in the title so they stand out at a glance.

## Subscribe

Visit the landing page to pick your city and calculation system and copy your `webcal://` URL:

**[socraticsurge.github.io/telugu-calendar-utilities](https://socraticsurge.github.io/telugu-calendar-utilities)**

## What's in each day's event

- **Metadata** — Samvatsara, Maasam, Paksham, Vaaram, solar and lunar signs
- **Pancha Anga** — Tithi, Nakshatra, Yoga, Karana with start/end times
- **Sky markers** — Sunrise, Sunset, Moonrise, Moonset
- **Auspicious windows** — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam
- **Inauspicious windows** — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham
- **Choghadiya** — 8 day blocks with names

## Cities

**Telugu Heartland** — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore

**Major Indian Metros** — Bengaluru, Chennai, Mumbai, Delhi

**International Diaspora** — Dallas, San Jose, San Francisco, Edison (NJ), New York, London, Sydney, Dubai

## Calculation Systems

| System | Basis | Best for |
|--------|-------|----------|
| **Drik Ganita** | Swiss Ephemeris (pyswisseph) + Lahiri ayanamsa | Modern apps, accurate sky events |
| **Surya Siddhanta** | Mean-motion algorithms from classical SS text | Temple rituals, TTD-style timing |
| **Vakya** | Surya Siddhanta + published correction tables | Traditional Telugu/Tamil printed Panchangams |

## MCP Server

`mcp-server-panchangam` is available on PyPI. Add it to any MCP-compatible AI assistant in one step.

**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "panchangam": {
      "command": "uvx",
      "args": ["mcp-server-panchangam"]
    }
  }
}
```

**Claude Code** — run once:

```bash
claude mcp add panchangam -- uvx mcp-server-panchangam
```

### Available tools

| Tool | Description |
|------|-------------|
| `list_supported_cities` | 22 pre-configured cities with lat/lon/timezone |
| `get_panchangam` | Full Panchangam for any date and city |
| `get_muhurta` | Auspicious/inauspicious windows only |
| `get_special_days` | Ekadashi, Amavasya, Pournami, Pradosham, Sankranti for a month |

All tools accept any free-text city name. Pre-configured cities resolve instantly; any other city is geocoded via OpenStreetMap. You can also pass `latitude`, `longitude`, and `timezone` directly.

## How it works

Feeds are generated on the 1st of every month via GitHub Actions, covering 18 months ahead. They are served as static `.ics` files from GitHub Pages — zero hosting cost.

```
GitHub Actions (monthly cron)
  → python -m src.generate   (22 cities × 3 systems = 66 feeds)
  → feeds/*.ics
  → GitHub Pages (webcal:// subscriptions)
```

## Development

```bash
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pytest tests/ -v
python -m src.generate   # writes to feeds/
```

## Roadmap

- **Plan A** ✅ — Drik Ganita engine + ICS pipeline + landing page
- **Plan B** ✅ — Surya Siddhanta engine
- **Plan C** ✅ — Vakya engine
- **Phase 2** — MCP server (`get_panchangam(date, location, system)` for AI assistants), Tarabalam personalization, Chrome extension
