mcp-server-panchangam
This server provides comprehensive Telugu Panchangam (Hindu calendar) calculations, astrological data, and auspicious timing tools. Key capabilities include:
Daily Panchangam: Full details for any date and city — Tithi, Nakshatra, Yoga, Karana, sunrise/sunset/moonrise/moonset, auspicious windows (Brahma Muhurta, Abhijit, Amrita Kalam), inauspicious windows (Rahu Kalam, Gulika, Yamagandam), Choghadiya, special yogas, and more.
Muhurta Planning: Find ranked auspicious time slots (
find_muhurta) with activity-aware filtering (Tarabalam, Chandrabalam, Lagna Shuddhi, Disha Shoola, Bhadra/Panchaka/Khar Maasa), or get quick muhurta windows for a single day.Panchanga Shuddhi: Assess five-limb purity for a date, with per-limb quality and verdict (Sarva Shuddha → Sarva Ashuddha).
Date Range & Special Days: Compact Panchangam summaries over up to 31 days, or list special days (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) for a month.
Tarabalam & Chandrabalam: Identify auspicious days for up to 4 people by birth star and rashi over up to 60 days.
Sky Events: Combustion calendar (Asta/Udaya for Mercury, Venus, Mars, Jupiter, Saturn), Graha Yuddha (planetary war) periods, and rashi ingresses for classical planets.
Eclipse Calendar: Solar and lunar eclipses with per-city visibility and Sutak timing (up to 2 years).
Graha Positions & Transits: Sidereal positions for all nine grahas at sunrise, Gochara (transit) verdicts for a natal Moon sign, and daily Rasi Phalalu readings.
Intraday Timing: Daily planetary horas (24 planetary hours) and Lagna (Ascendant) transitions throughout a day.
Utility: List 22 pre-configured cities with coordinates and timezones; custom locations can be passed directly or geocoded via OpenStreetMap.
Supports multiple calculation systems (Drik Ganita, Surya Siddhanta, Vakya) and ayanamsas (Lahiri, Raman, Krishnamurti, True Chitrapaksha).
Allows subscribing to Panchangam calendar feeds in Google Calendar as .ics files.
Used to geocode city names for accurate Panchangam calculations.
Enables sharing Panchangam details, Tarabalam, Muhurtam, and Gochara charts via WhatsApp.
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).
Guests can also create browser-local profiles from known astrology details. Local development and an
explicitly activated public build can calculate Nakshatra, Padam, Janma Rashi, Lagna, and a reviewable
D1 chart from date, exact time, and birthplace. Public builds fail closed until the licensed calculation
service and place provider are approved; saved calculated profiles remain viewable. The name never leaves
the browser. See the calculation and privacy contract.
Drik Muhurtam searches also contain a source-backed candidate-time chart
post-screen, guarded by an independent fail-closed flag. Public builds make no
chart request unless VITE_ELECTION_CHART_API_ENABLED is exactly true; see
the screening method and release boundary.
Everything is shareable to WhatsApp.

Related MCP server: mcp-indian-astrology
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-panchangamAvailable tools
Daily Panchangam
Tool | Description |
| Full Panchangam for any date and city |
| One day's auspicious/inauspicious windows (lighter call; use |
| Five-limb purity verdict (Sarva Shuddha → Sarva Ashuddha) with per-limb quality and reason |
Planning across days
Tool | Description |
| Compact Panchangam summary for each day in a range (max 31 days) |
| Named festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, and Eclipses for a month |
| Ranked auspicious time slots — activity-aware, every slot with its reasons |
| Tarabalam & Chandrabalam — days favourable for 1–4 people by birth star (and rashi) |
Sky events
Tool | Description |
| Asta/Udaya (combustion entry/exit) periods for Mercury, Venus, Mars, Jupiter, Saturn |
| Graha Yuddha (planetary war) periods — winner, loser, timing in UTC |
| All rashi sign-change events for the classical planets over a date range |
| Solar and lunar eclipses with per-city visibility and Sutak timing |
Gochara and personal transits
Tool | Description |
| All nine grahas at sunrise — rasi, nakshatra, retrograde, next-rasi dates |
| Gochara verdicts from a janma rashi — houses, vedha, Sade Sati / Ashtama Shani |
| Deterministic daily reading rendered from computed facts |
Intraday timing
Tool | Description |
| 24 planetary hours (horas) for the day, starting at sunrise with the weekday lord |
| Ascendant (Lagna) sign boundaries tracking the eastern horizon across the day |
Utility
Tool | Description |
| 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)Maintenance and roadmap
The active maintenance queue is the Telugu Calendar Utilities GitHub Project. Use the linked status and priority fields to see what is planned, in progress, or ready for review. File defects and feature proposals in repository Issues.
The CSV files and phase plans under docs/tracking/ are preserved historical
records; they are not a second backlog.
Documentation
The repository is the canonical documentation source. Start with the
documentation standard for where current reference,
operations, decisions, and historical material belong, then use the
computation reference index for the detailed
system map. A searchable VitePress projection is built from these files at
/docs/; it is disposable presentation output and does not replace the
repository as the source of truth.
Development
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
npm install
python tools/verify_project.py
python -m telugu_panchangam.generate # writes to feeds/Available Tools
1 toolget_special_daysA
Returns a JSON list of special days in a given month: Ekadashi (fasting days), Amavasya (new moon), Pournami (full moon), Pradosham, Sankranti, and Eclipses. Args: year=e.g. 2026, month=1-12, city=city name (or pass latitude+longitude; timezone is derived if omitted), system=drik|surya_siddhanta|vakya (default: drik).
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| year | Yes | ||
| month | Yes | ||
| system | No | drik | |
| latitude | No | ||
| timezone | No | ||
| longitude | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses key behaviors: the tool returns a JSON list, allows city name or coordinates, derives timezone if omitted, and defaults to the 'drik' system. It does not discuss authentication, rate limits, or error handling, but covers essential behavior for usage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that efficiently conveys the purpose and major argument details. It is front-loaded with the main function. Although somewhat lengthy, it avoids unnecessary words and is well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema (signaled), the description focuses on inputs and behavior. It covers the required parameters and key optional ones, explaining fallbacks. The overall usage context is complete for an agent to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage, so the description must compensate. It adds meaningful context for parameters: city can be name or lat/lon, timezone is derived automatically, system has default and possible values. It provides example values for year and month. While not all 7 parameters are fully detailed, the key ones are addressed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool returns a JSON list of special days for a given month, explicitly listing types like Ekadashi, Amavasya, etc. This differentiates it from sibling tools that focus on other calendar events like eclipses or graha positions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear usage context, specifying required arguments (year, month, city) and optional parameters with defaults. However, it does not explicitly state when to use this tool versus alternatives, though the list of special days implicitly guides selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Only one tool exists, so there is no possibility of confusion or overlap.
With a single tool, the naming convention is inherently consistent.
A panchangam server with only one tool is extremely limited; typical panchangam APIs offer many more elements like daily tithi, nakshatra, etc.
The tool only retrieves special days in a month, missing the vast majority of panchangam data (daily calendars, muhurta, etc.), making the server severely incomplete for its domain.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Professional Vedic astrology tools for AI agents via MCP.
Vedic kundli, panchang, dashas, nakshatras and KP charts for AI agents, one API key.
Official Divine API MCP for Indian/Vedic Astrology: Panchang, Kundli, Dasha, KP, Lal Kitab.
Observatory-grade Indian astronomy, years -5000..+5000: positions, eclipses, panchang date search.
Related MCP Servers
- FlicenseAqualityAmaintenanceVedaksha MCP Server Astronomical ephemeris and Vedic astrology computation for AI agents via the Model Context Protocol.172
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access Indian Vedic astrology services including Panchang, Kundli, matchmaking, and festivals through natural language.MIT
- AlicenseAqualityAmaintenanceHosted Streamable HTTP MCP server for Vedic astrology: panchang, kundali (birth chart), matchmaking, dashas, doshas, muhurta and 16 tools computed by a precision astronomy engine.1753MIT

bda-mcpofficial
AlicenseNot gradedqualityCmaintenanceAn MCP server providing Jyotish, Panchang, and Sanatan Dharma knowledge tools including panchang computation, festival calendars, muhurat windows, Jyotish concept explanations, and a source-grounded Sanatan encyclopedia with citations and provenance metadata.MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/socraticsurge/telugu-calendar-utilities'
If you have feedback or need assistance with the MCP directory API, please join our Discord server