{
  "markdown": "# Telugu Panchangam Calendar Feeds\n\nSubscribable Telugu Panchangam feeds for 22 cities — delivered as `.ics` files you can add to Google Calendar, Apple Calendar, or Outlook.\n\nEvery day appears as an all-day event (no calendar blocking) with full Panchangam details in the description. Festival days — Ugadi, Vinayaka Chavithi, Deepavali, Maha Shivaratri, the Sankranti cluster, and 30+ more — are marked with 🪔 in the title; other special days (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) with ⚡.\n\n![Today's Panchangam at panchangam.astrochaganti.com](docs/screenshots/01-panchangam.png)\n\n## Subscribe\n\nVisit the landing page to pick your city and calculation system and copy your `webcal://` URL:\n\n**[panchangam.astrochaganti.com](https://panchangam.astrochaganti.com)**\n\nThe site is also a daily toolkit: **Today's Panchangam** (any date, any city), **Tarabalam · Muhurtam**\n(good days and ranked time slots for up to four people by birth star, with Chandrabalam), and the\n**Gochara chart with Rasi Phalalu** (South Indian chart, transit verdicts and a computed daily reading).\nGuests can also create browser-local profiles from known astrology details. Local development and an\nexplicitly activated public build can calculate Nakshatra, Padam, Janma Rashi, Lagna, and a reviewable\nD1 chart from date, exact time, and birthplace. Public builds fail closed until the licensed calculation\nservice and place provider are approved; saved calculated profiles remain viewable. The name never leaves\nthe browser. See the [calculation and privacy contract](docs/reference/53-birth-profile-calculation.md).\nDrik Muhurtam searches also contain a source-backed candidate-time chart\npost-screen, guarded by an independent fail-closed flag. Public builds make no\nchart request unless `VITE_ELECTION_CHART_API_ENABLED` is exactly `true`; see\nthe [screening method and release boundary](docs/reference/54-muhurtam-election-chart-screening.md).\nEverything is shareable to WhatsApp.\n\n<details>\n<summary>What subscribing looks like</summary>\n\n![Subscribe flow — pick a feed, copy the webcal URL, add to your calendar](docs/screenshots/02-subscribe.png)\n\n</details>\n\n## What's in each day's event\n\n- **Metadata** — Samvatsara, Maasam, Paksham, Vaaram, solar and lunar signs\n- **Pancha Anga** — Tithi, Nakshatra, Yoga, Karana with start/end times\n- **Sky markers** — Sunrise, Sunset, Moonrise, Moonset\n- **Auspicious windows** — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam\n- **Inauspicious windows** — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham\n- **Choghadiya** — 8 day blocks with names\n- **Eclipses** — Solar and lunar eclipses with type (Total/Partial/Annular/Penumbral), visibility from your city, eclipse window, and Sutak period\n- **Special Yogas** — Sarvartha Siddhi, Amrita Siddhi, Visha, and Dagdha yogas based on weekday/tithi/nakshatra combination\n\n## Cities\n\n**Telugu Heartland** — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore\n\n**Major Indian Metros** — Bengaluru, Chennai, Mumbai, Delhi\n\n**International Diaspora** — Dallas, San Jose, San Francisco, Edison (NJ), New York, London, Sydney, Dubai\n\n## Calculation Systems\n\n| System | Basis | Best for |\n|--------|-------|----------|\n| **Drik Ganita** | Swiss Ephemeris (pyswisseph) — supports Lahiri, Raman, Krishnamurti, True Chitrapaksha ayanamsas | Modern apps, accurate sky events |\n| **Surya Siddhanta** | Mean-motion algorithms from classical SS text | Traditions rooted in classical siddhantic calculation |\n| **Vakya** | Surya Siddhanta + published correction tables | Traditional Telugu/Tamil printed Panchangams |\n\n## MCP Server\n\n`mcp-server-panchangam` is available on PyPI. It's a standard MCP stdio server (`uvx mcp-server-panchangam`), so it works with any MCP-compatible client or agent — Claude Desktop, Claude Code, Cursor, Windsurf, and custom agents built on the MCP SDK. Below are examples for a couple of common clients; for others, point your client's MCP config at the same `uvx mcp-server-panchangam` command.\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"panchangam\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-panchangam\"]\n    }\n  }\n}\n```\n\n**Claude Code** — run once:\n\n```bash\nclaude mcp add panchangam -- uvx mcp-server-panchangam\n```\n\n### Available tools\n\n**Daily Panchangam**\n\n| Tool | Description |\n|------|-------------|\n| `get_panchangam` | Full Panchangam for any date and city |\n| `get_muhurta` | One day's auspicious/inauspicious windows (lighter call; use `find_muhurta` to search across days) |\n| `get_panchanga_shuddhi` | Five-limb purity verdict (Sarva Shuddha → Sarva Ashuddha) with per-limb quality and reason |\n\n**Planning across days**\n\n| Tool | Description |\n|------|-------------|\n| `get_panchangam_range` | Compact Panchangam summary for each day in a range (max 31 days) |\n| `get_special_days` | Named festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, and Eclipses for a month |\n| `find_muhurta` | Ranked auspicious time slots — activity-aware, every slot with its reasons |\n| `find_tarabalam_days` | Tarabalam & Chandrabalam — days favourable for 1–4 people by birth star (and rashi) |\n\n**Sky events**\n\n| Tool | Description |\n|------|-------------|\n| `get_combustion_calendar` | Asta/Udaya (combustion entry/exit) periods for Mercury, Venus, Mars, Jupiter, Saturn |\n| `get_graha_yuddha` | Graha Yuddha (planetary war) periods — winner, loser, timing in UTC |\n| `get_rashi_ingresses` | All rashi sign-change events for the classical planets over a date range |\n| `get_eclipse_calendar` | Solar and lunar eclipses with per-city visibility and Sutak timing |\n\n**Gochara and personal transits**\n\n| Tool | Description |\n|------|-------------|\n| `get_graha_positions` | All nine grahas at sunrise — rasi, nakshatra, retrograde, next-rasi dates |\n| `get_gochara` | Gochara verdicts from a janma rashi — houses, vedha, Sade Sati / Ashtama Shani |\n| `get_rasi_phalalu` | Deterministic daily reading rendered from computed facts |\n\n**Intraday timing**\n\n| Tool | Description |\n|------|-------------|\n| `get_daily_horas` | 24 planetary hours (horas) for the day, starting at sunrise with the weekday lord |\n| `get_lagna_transitions` | Ascendant (Lagna) sign boundaries tracking the eastern horizon across the day |\n\n**Utility**\n\n| Tool | Description |\n|------|-------------|\n| `list_supported_cities` | 22 pre-configured cities with lat/lon/timezone |\n\nAll 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.\n\nDrik-system tools that accept a `city` or date also accept `ayanamsa=lahiri|raman|krishnamurti|true_chitrapaksha` (default: `lahiri`). Full API documentation and parameter details: [mcp-server-panchangam on PyPI](https://pypi.org/project/mcp-server-panchangam/).\n\n## How it works\n\nFeeds 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.\n\n```\nGitHub Actions (monthly cron)\n  → python -m telugu_panchangam.generate   (22 cities × 3 systems = 66 feeds)\n  → feeds/*.ics\n  → GitHub Pages (webcal:// subscriptions)\n```\n\n## Maintenance and roadmap\n\nThe active maintenance queue is the\n**[Telugu Calendar Utilities GitHub Project](https://github.com/users/socraticsurge/projects/2)**.\nUse the linked status and priority fields to see what is planned, in progress,\nor ready for review. File defects and feature proposals in\n**[repository Issues](https://github.com/socraticsurge/telugu-calendar-utilities/issues)**.\n\nThe CSV files and phase plans under `docs/tracking/` are preserved historical\nrecords; they are not a second backlog.\n\n## Documentation\n\nThe repository is the canonical documentation source. Start with the\n**[documentation standard](docs/README.md)** for where current reference,\noperations, decisions, and historical material belong, then use the\n**[computation reference index](docs/reference/README.md)** for the detailed\nsystem map. A searchable VitePress projection is built from these files at\n`/docs/`; it is disposable presentation output and does not replace the\nrepository as the source of truth.\n\n## License and corresponding source\n\nCopyright (C) 2026 Vinay Chaganti.\n\nThis project is free software under the\n[GNU Affero General Public License v3.0 or later](LICENSE). Users of the\nwebsite and MCP package can obtain the complete corresponding source,\nincluding build instructions and tests, from this repository. Direct\ndependency notices for PySwissEph and Swiss Ephemeris are preserved in\n[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).\n\nThis project selects the AGPL path in Swiss Ephemeris's dual-license model.\nEarlier copies remain available under the licence terms conveyed with those\ncopies; this release does not withdraw an earlier grant.\n\n## Development\n\nRequires Python 3.10+, [uv](https://docs.astral.sh/uv/), and Node.js 24.\n\n```bash\nuv sync --locked --extra test --extra browser-test\nuv run playwright install chromium\nnpm ci --ignore-scripts\nuv run python tools/verify_project.py\nuv run python -m telugu_panchangam.generate   # writes to feeds/\n```\n",
  "bytes": 9339,
  "sha": "e90e9083ecb6d3b4080248086181b2f6f466637b9daa5471773ff97bd41f8ecf",
  "repo_slug": "socraticsurge/telugu-calendar-utilities",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_socraticsurge_panchangam_1eb6df61/readme"
}