socraticsurge/telugu-calendar-utilities

๐Ÿ”ฎ Spirituality & Esoterica
0 Views
0 Installs

๐Ÿ ๐Ÿ  - Telugu Panchangam (Hindu almanac): tithi, nakshatra, muhurta windows, 30+ festivals, tarabalam & chandrabalam good-day finder, gochara transits and a deterministic daily rasi phalalu โ€” Swiss Ephemeris precision, every rule pinned against reference almanacs, by AstroChaganti. uvx mcp-server-panchangam.

Quick Install

One-Click IDE Configuration
claude_desktop_config.json
{
  "mcpServers": {
    "socraticsurge-telugu-calendar-utilities": {
      "command": "npx",
      "args": [
        "-y",
        "socraticsurge-telugu-calendar-utilities"
      ]
    }
  }
}
Or

Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.

Documentation Overview

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:

panchangam.astrochaganti.com

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.

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

SystemBasisBest for
Drik GanitaSwiss Ephemeris (pyswisseph) โ€” supports Lahiri, Raman, Krishnamurti, True Chitrapaksha ayanamsasModern apps, accurate sky events
Surya SiddhantaMean-motion algorithms from classical SS textTraditions rooted in classical siddhantic calculation
VakyaSurya Siddhanta + published correction tablesTraditional 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

ToolDescription
get_panchangamFull Panchangam for any date and city
get_muhurtaOne day's auspicious/inauspicious windows (lighter call; use find_muhurta to search across days)
get_panchanga_shuddhiFive-limb purity verdict (Sarva Shuddha โ†’ Sarva Ashuddha) with per-limb quality and reason

Planning across days

ToolDescription
get_panchangam_rangeCompact Panchangam summary for each day in a range (max 31 days)
get_special_daysNamed festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, and Eclipses for a month
find_muhurtaRanked auspicious time slots โ€” activity-aware, every slot with its reasons
find_tarabalam_daysTarabalam & Chandrabalam โ€” days favourable for 1โ€“4 people by birth star (and rashi)

Sky events

ToolDescription
get_combustion_calendarAsta/Udaya (combustion entry/exit) periods for Mercury, Venus, Mars, Jupiter, Saturn
get_graha_yuddhaGraha Yuddha (planetary war) periods โ€” winner, loser, timing in UTC
get_rashi_ingressesAll rashi sign-change events for the classical planets over a date range
get_eclipse_calendarSolar and lunar eclipses with per-city visibility and Sutak timing

Gochara and personal transits

ToolDescription
get_graha_positionsAll nine grahas at sunrise โ€” rasi, nakshatra, retrograde, next-rasi dates
get_gocharaGochara verdicts from a janma rashi โ€” houses, vedha, Sade Sati / Ashtama Shani
get_rasi_phalaluDeterministic daily reading rendered from computed facts

Intraday timing

ToolDescription
get_daily_horas24 planetary hours (horas) for the day, starting at sunrise with the weekday lord
get_lagna_transitionsAscendant (Lagna) sign boundaries tracking the eastern horizon across the day

Utility

ToolDescription
list_supported_cities22 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
npm install
python tools/verify_project.py
python -m telugu_panchangam.generate   # writes to feeds/

Related MCP Servers

adityarya24/astro-skill

๐Ÿ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Open-source Vedic astrology engine and stdio MCP server โ€” deterministic kundali, Vimshottari dasha (maha/antar/pratyantar), panchang, gochar + Sade Sati, ashtakavarga, guna milan, divisional charts, and 12-page Hindi janma patrika PDFs. Bundled Swiss Ephemeris, SQLite client storage, no API key.

๐Ÿ”ฎ Spirituality & Esoterica0 views
astroway/astroway-mcp

๐Ÿ“‡ โ˜๏ธ ๐ŸŽ ๐ŸชŸ ๐Ÿง - Comprehensive astrology MCP exposing every endpoint of the AstroWay Calculation API โ€” natal charts, synastry, transits, Vedic dashas (Vimshottari, Yogini, Ashtottari, Kalachakra), 16 Vargas, Tarot (Rider-Waite-Smith / Marseille / Lenormand), Numerology (5 systems), Human Design, AI horoscopes. Sub-arcsecond Swiss Ephemeris precision, 10 000 free credits/month. Install: npx @astroway/mcp.

๐Ÿ”ฎ Spirituality & Esoterica0 views
davidmosiah/astral-mcp

๐Ÿ“‡ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Zero-setup astrology MCP server for natal charts, current transits, synastry, Moon phases and birthplace lookup, with privacy modes for compact agent payloads.

๐Ÿ”ฎ Spirituality & Esoterica0 views
openfate-ai/bazi-mcp

๐Ÿ“‡ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Deterministic Bazi / Four Pillars MCP server with True Solar Time, lunar/solar conversion, Da Yun luck cycles, branch interactions, reverse Bazi lookup, and OpenFate calculation metadata. Install: npx -y @openfate/bazi-mcp.

๐Ÿ”ฎ Spirituality & Esoterica0 views

Engagement

Views
0
Installs
0
Upvotes
0

Views and upvotes are unique per visitor network (hashed IP). Installs count copy actions.

Status

Health: Not checked yet

We have not completed a health check for this listing yet.

No check timestamp yet.

Unclaimed listing (imported or pending owner verification). Claim it โ†’
โ˜… Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Claim this listing

Promote this listing

Optional paid placement. Free listings stay free forever.

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.