
Panchangam
io.github.socraticsurgePublished by GitHub account socraticsurgev1.6.2Updated Oct 27, 2026
Telugu Panchangam: tithi, nakshatra, muhurtas, festivals, tarabalam, gochara, daily rasi phalalu
Overview
Local MCP server that gives an assistant Telugu Panchangam data: tithi, nakshatra, muhurtas, festivals, tarabalam, gochara and daily rasi phalalu for a date…
- What you can do
- Get a full day's Panchangam, muhurta windows or a five-limb purity verdict for a date and city
- Plan across days: compact range summaries (up to 31 days), monthly festival and special-day lists, ranked auspicious slots, and tarabalam/chandrabalam days for up to four people
- Look up sky events: combustion periods, planetary wars, rashi ingresses and eclipses with per-city visibility
- Read gochara transits, graha positions at sunrise and a computed daily rasi phalalu reading
- Get intraday timing: 24 planetary horas and lagna transitions
- List the 22 pre-configured cities; other cities are geocoded, or pass latitude, longitude and timezone directly
- When to use it
- Useful when you want an assistant to answer Telugu calendar questions, pick auspicious times for an activity, plan around festivals and eclipses, or check transits against a birth star or rashi, without opening a separate site.
- Requirements
- Runs locally as a stdio process via uvx from the PyPI package mcp-server-panchangam, so Python and uv are needed. No authentication, environment variables or headers are declared. Cities outside the 22 pre-configured ones are geocoded through OpenStreetMap, so network access is needed for those.
Installation
In SourceWeft
- Open Panchangam in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
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 ⚡.
[Today's Panchangam at panchangam.astrochaganti.com]
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.
What subscribing looks like
[Subscribe flow — pick a feed, copy the webcal URL, add to your calendar]
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
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:
Claude Code — run once:
Available tools
Daily Panchangam
Planning across days
Sky events
Gochara and personal transits
Intraday timing
Utility
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.
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.
License and corresponding source
Copyright (C) 2026 Vinay Chaganti.
This project is free software under the GNU Affero General Public License v3.0 or later. Users of the website and MCP package can obtain the complete corresponding source, including build instructions and tests, from this repository. Direct dependency notices for PySwissEph and Swiss Ephemeris are preserved in THIRD_PARTY_NOTICES.md.
This project selects the AGPL path in Swiss Ephemeris's dual-license model. Earlier copies remain available under the licence terms conveyed with those copies; this release does not withdraw an earlier grant.
Development
Requires Python 3.10+, uv, and Node.js 24.
Source: README.md at commit 7c5ebfb
Tools
0Version history
1- v1.6.2LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts