mcp-server-panchangam
Telugu Panchangam for AI assistants: daily panchangam, muhurta windows, tarabalam, festivals, eclipses, gochara and planetary positions for any city, computed in three classical systems (Drik Ganita, Surya Siddhanta, Vakya). 17 tools; runs via uvx mcp-server-panchangam.
README
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. 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 โก.

Subscribe
Visit the landing page to pick your city and calculation system and copy your webcal:// URL:
The site is also a daily toolkit: Today's Panchangam (any date, any city), Tarabalam ยท Muhurtam (good days and ranked time slots for up to four people by birth star, with Chandrabalam), and the Gochara chart with Rasi Phalalu (South Indian chart, transit verdicts and a computed daily reading). Everything is shareable to WhatsApp.
<details> <summary>What subscribing looks like</summary>

</details>
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
- Eclipses โ Solar and lunar eclipses with type (Total/Partial/Annular/Penumbral), visibility from your city, eclipse window, and Sutak period
- Special Yogas โ Sarvartha Siddhi, Amrita Siddhi, Visha, and Dagdha yogas based on weekday/tithi/nakshatra combination
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) โ supports Lahiri, Raman, Krishnamurti, True Chitrapaksha ayanamsas | Modern apps, accurate sky events |
| Surya Siddhanta | Mean-motion algorithms from classical SS text | Traditions rooted in classical siddhantic calculation |
| Vakya | Surya Siddhanta + published correction tables | Traditional Telugu/Tamil printed Panchangams |
MCP Server
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.
Claude Desktop โ add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"panchangam": {
"command": "uvx",
"args": ["mcp-server-panchangam"]
}
}
}
Claude Code โ run once:
claude mcp add panchangam -- uvx mcp-server-panchangam
Available tools
Daily Panchangam
| Tool | Description |
|---|---|
get_panchangam |
Full Panchangam for any date and city |
get_muhurta |
One day's auspicious/inauspicious windows (lighter call; use find_muhurta to search across days) |
get_panchanga_shuddhi |
Five-limb purity verdict (Sarva Shuddha โ Sarva Ashuddha) with per-limb quality and reason |
Planning across days
| Tool | Description |
|---|---|
get_panchangam_range |
Compact Panchangam summary for each day in a range (max 31 days) |
get_special_days |
Named festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, and Eclipses for a month |
find_muhurta |
Ranked auspicious time slots โ activity-aware, every slot with its reasons |
find_tarabalam_days |
Tarabalam & Chandrabalam โ days favourable for 1โ4 people by birth star (and rashi) |
Sky events
| Tool | Description |
|---|---|
get_combustion_calendar |
Asta/Udaya (combustion entry/exit) periods for Mercury, Venus, Mars, Jupiter, Saturn |
get_graha_yuddha |
Graha Yuddha (planetary war) periods โ winner, loser, timing in UTC |
get_rashi_ingresses |
All rashi sign-change events for the classical planets over a date range |
get_eclipse_calendar |
Solar and lunar eclipses with per-city visibility and Sutak timing |
Gochara and personal transits
| Tool | Description |
|---|---|
get_graha_positions |
All nine grahas at sunrise โ rasi, nakshatra, retrograde, next-rasi dates |
get_gochara |
Gochara verdicts from a janma rashi โ houses, vedha, Sade Sati / Ashtama Shani |
get_rasi_phalalu |
Deterministic daily reading rendered from computed facts |
Intraday timing
| Tool | Description |
|---|---|
get_daily_horas |
24 planetary hours (horas) for the day, starting at sunrise with the weekday lord |
get_lagna_transitions |
Ascendant (Lagna) sign boundaries tracking the eastern horizon across the day |
Utility
| Tool | Description |
|---|---|
list_supported_cities |
22 pre-configured cities with lat/lon/timezone |
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.
Drik-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.
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 telugu_panchangam.generate (22 cities ร 3 systems = 66 feeds)
โ feeds/*.ics
โ GitHub Pages (webcal:// subscriptions)
Development
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pytest tests/ -v
python -m telugu_panchangam.generate # writes to feeds/
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.