How do I use panchangam-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@panchangam-mcp What is the panchangam for Chennai today?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

panchangam-mcp

by vgnshlvnz

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

panchangam-mcp

An MCP server that computes the Hindu almanac (panchangam) for a date and place and exposes it as six tools. Positions of the Sun and Moon come from the Swiss Ephemeris (Moshier model, sidereal / Lahiri ayanamsa — the same convention drikpanchang.com uses).

Tool	Answers
`get_panchangam`	The five limbs of a civil day — tithi, nakshatra, yoga, karana, vaara — plus sunrise and sunset. Use it for the lunar day, the Moon's phase, the nakshatra a date falls in, Ekadashi / Amavasya / Purnima and other Moon-based observances, or just local sunrise/sunset.
`get_muhurta`	The named auspicious and inauspicious periods within a day — Abhijit Muhurta, Rahu Kalam, Yamaganda, Gulika Kalam, Durmuhurtam — each with a start, an end, and whether to seek it or avoid it. Use it to pick or avoid a time of day.
`rasi_hora_table`	The 24 horas (one-hour slots from sunrise) of a day, each scored 0–100 for a rasi. Optional `score_breakdown` adds the three parts of each score. Use it to see or compare every hora of the day.
`best_horas`	The top-scoring favourable horas of a day for a rasi, optionally within a time range. Use it for "when is a good time between 9 and 5?".
`current_hora`	The hora in force right now at a place, scored for a rasi.
`personal_muhurta`	A stored person's personal daily card (tarabala, chandrabala, chandrashtama warning, good lagna windows, kalams) from `profiles.yaml`. Not documented further here.

Every timestamp returned by get_panchangam and get_muhurta is a timezone-aware, second-precision ISO-8601 string in the location's own zone (2026-09-06T07:06:49+08:00). The hora tools return local "HH:MM" times plus the date.

Requirements

Python 3.12. The pyswisseph dependency has no prebuilt wheel for 3.13+. uv is the easiest way to get a 3.12 interpreter without touching the system Python.

Related MCP server: StarMeet MCP Server

Install

uv venv --python 3.12 .venv
uv pip install -e .

or with plain pip in a 3.12 environment:

pip install -e .

This installs the panchangam-mcp console script.

Run

The server speaks MCP over either transport:

# stdio — the client launches this process and talks to it over stdin/stdout
panchangam-mcp                       # --transport stdio is the default

# Streamable HTTP — long-running server, MCP endpoint at http://<host>:<port>/mcp
panchangam-mcp --transport http --host 127.0.0.1 --port 8765

--host and --port apply to http only and default to 127.0.0.1:8765.

Connect an MCP client

Claude Code

# stdio
claude mcp add panchangam -- panchangam-mcp

# or, against a running HTTP server
claude mcp add --transport http panchangam http://127.0.0.1:8765/mcp

Any client that reads an MCP server config

stdio:

{
  "mcpServers": {
    "panchangam": {
      "command": "panchangam-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

HTTP (server started separately):

{
  "mcpServers": {
    "panchangam": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

If panchangam-mcp is not on the client's PATH, use the absolute path to the script inside your virtualenv (/path/to/.venv/bin/panchangam-mcp).

Tools

get_panchangam and get_muhurta take the same four arguments (the hora tools are documented below):

Argument	Type	Notes
`date`	string	Civil date, ISO-8601 `YYYY-MM-DD`, zero-padded (`2026-09-06`). Time of day is not used.
`lat`	number	Latitude in degrees, north positive, −90 to 90.
`lon`	number	Longitude in degrees, east positive, −180 to 180.
`tz`	string	IANA timezone name (`Asia/Kolkata`, `America/New_York`). A bare UTC offset like `+05:30` is rejected — the named zone is needed to line civil days up with local sunrise and to handle DST.

The traditional day runs from one sunrise to the next, so a span can start before the requested date and end after it. When a boundary falls during the day, both segments are listed in chronological order (ends of one equals starts of the next).

`get_panchangam`

Request:

{ "date": "2026-09-06", "lat": 3.14111, "lon": 101.68639, "tz": "Asia/Kuala_Lumpur" }

Response:

{
  "location": {
    "name": "query location",
    "latitude": 3.14111,
    "longitude": 101.68639,
    "timezone": "Asia/Kuala_Lumpur"
  },
  "date": "2026-09-06",
  "weekday": "Ravivara",
  "sunrise": "2026-09-06T07:06:49+08:00",
  "sunset": "2026-09-06T19:16:32+08:00",
  "tithi": [
    { "name": "Krishna Dashami",  "number": 25, "starts": "2026-09-06T00:24:11+08:00", "ends": "2026-09-06T21:59:43+08:00" },
    { "name": "Krishna Ekadashi", "number": 26, "starts": "2026-09-06T21:59:43+08:00", "ends": "2026-09-07T19:34:38+08:00" }
  ],
  "nakshatra": [
    { "name": "Ardra",     "number": 6, "starts": "2026-09-06T00:01:01+08:00", "ends": "2026-09-06T22:22:56+08:00" },
    { "name": "Punarvasu", "number": 7, "starts": "2026-09-06T22:22:56+08:00", "ends": "2026-09-07T20:44:16+08:00" }
  ],
  "yoga": [
    { "name": "Siddhi",    "number": 16, "starts": "2026-09-05T15:17:08+08:00", "ends": "2026-09-06T12:15:11+08:00" },
    { "name": "Vyatipata", "number": 17, "starts": "2026-09-06T12:15:11+08:00", "ends": "2026-09-07T09:11:08+08:00" }
  ],
  "karana": [
    { "name": "Vanija", "number": 49, "starts": "2026-09-06T00:24:11+08:00", "ends": "2026-09-06T11:12:17+08:00" },
    { "name": "Vishti", "number": 50, "starts": "2026-09-06T11:12:17+08:00", "ends": "2026-09-06T21:59:43+08:00" },
    { "name": "Bava",   "number": 51, "starts": "2026-09-06T21:59:43+08:00", "ends": "2026-09-07T08:46:59+08:00" }
  ]
}

number is the 1-based index within each cycle: tithi 1–30, nakshatra 1–27, yoga 1–27, karana 1–60. weekday is the vaara, fixed for the whole sunrise-to-sunrise day.

`get_muhurta`

Same request shape. Response:

{
  "location": { "name": "query location", "latitude": 3.14111, "longitude": 101.68639, "timezone": "Asia/Kuala_Lumpur" },
  "date": "2026-09-06",
  "periods": [
    { "name": "Abhijit Muhurta", "auspicious": true,  "starts": "2026-09-06T12:47:21+08:00", "ends": "2026-09-06T13:36:00+08:00" },
    { "name": "Rahu Kalam",      "auspicious": false, "starts": "2026-09-06T17:45:19+08:00", "ends": "2026-09-06T19:16:32+08:00" },
    { "name": "Yamaganda",       "auspicious": false, "starts": "2026-09-06T13:11:41+08:00", "ends": "2026-09-06T14:42:54+08:00" },
    { "name": "Gulika Kalam",    "auspicious": false, "starts": "2026-09-06T16:14:07+08:00", "ends": "2026-09-06T17:45:19+08:00" },
    { "name": "Durmuhurtam",     "auspicious": false, "starts": "2026-09-06T17:39:15+08:00", "ends": "2026-09-06T18:27:53+08:00" }
  ]
}

Every period is a fixed division of the daylight span, so the times depend on the place's sunrise and sunset.

Errors

A bad request comes back as a tool error (isError: true) with a message the caller can act on, not a stack trace:

invalid arguments: date must be an ISO-8601 calendar date with zero-padded fields, like '2026-09-06'; got '6 Sept 2026'
invalid arguments: tz must be an IANA timezone name like 'Asia/Kuala_Lumpur' (not a UTC offset); '+08:00' is not a known zone
invalid arguments: lat must be between -90 and 90 degrees, got 999.0
cannot compute: Sun has no rise at query location on 2026-12-21

cannot compute: means the request was well-formed but has no answer — for example a polar location where the Sun does not rise or set on that date.

Hora tools

A hora is a one-hour slot starting at sunrise. Hora 1 is ruled by the weekday's lord and the lords then cycle Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars, so a day has 24 horas. Each hora is scored 0–100 for a rasi as the sum of three parts: nature (the hora lord's own character), friendship (the hora lord's relation to the rasi's lord) and gochara (whether the hora lord's position at that hora's start is a good house counted from the rasi).

The scoring tables are provisional defaults and have not been verified against a printed source. Treat scores as indicative.

Both tools take:

Argument	Type	Notes
`rasi`	integer	Required. 1–12: 1 Mesha/Aries … 12 Meena/Pisces (usually the person's Moon sign).
`date`	string	Optional. `YYYY-MM-DD`; defaults to today at the place. The hora day runs from that date's sunrise to the next.
`lat`, `lon`, `tz`	number, number, string	Optional. Default to Petaling Jaya (3.1073, 101.6067, `Asia/Kuala_Lumpur`).

Times are local "HH:MM". Horas after midnight show early-morning times and still belong to the same day.

`rasi_hora_table`

Extra argument: score_breakdown (boolean, default false). When true, each row also has nature, friendship and gochara.

{ "rasi": 4, "date": "2026-09-24" }

{
  "date": "2026-09-24",
  "rasi": 4,
  "horas": [
    { "hora": 1, "lord": "Jupiter", "score": 45, "start": "07:02", "end": "08:02" },
    { "hora": 2, "lord": "Mars",    "score": 25, "start": "08:02", "end": "09:02" },
    "... 22 more"
  ]
}

`best_horas`

Extra arguments: count (1–24, default 3), from_time (inclusive) and to_time (exclusive), both 24-hour "HH:MM" and matched against each hora's start; from_time must be earlier than to_time. Only favourable horas (score 60 or more) are returned, best first, so fewer than count may come back.

{ "rasi": 4, "date": "2026-09-24", "count": 3, "from_time": "09:00", "to_time": "17:00" }

{
  "date": "2026-09-24",
  "rasi": 4,
  "horas": [
    { "hora": 4,  "lord": "Venus", "score": 85, "start": "10:02", "end": "11:02" },
    { "hora": 3,  "lord": "Sun",   "score": 80, "start": "09:02", "end": "10:02" },
    { "hora": 10, "lord": "Sun",   "score": 80, "start": "16:02", "end": "17:02" }
  ]
}

Settings

A hora ruled by the rasi's own lord never scores below own_lord_floor (default 60). Set it in ~/.config/panchangam/profiles.yaml, an integer 0–100, read once when the server starts:

settings:
  hora:
    own_lord_floor: 60

Development

uv venv --python 3.12 .venv
uv pip install -e ".[dev]"
.venv/bin/pytest -q

The tool-surface tests don't need Swiss Ephemeris (the backend-backed ones skip if it's absent), so a quick check without a 3.12 build works too:

pytest tests/test_server.py -q

load_provider() in src/panchangam/server.py is the single place the calculation backend is chosen; everything downstream takes the provider as an argument.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Vedic Astrology and Kundli MCP Server by RoxyAPI A
com.roxyapi
Vedic kundli, panchang, dashas, nakshatras and KP charts for AI agents, one API key.
Art & Culture
582
HinduCalendar — panchang, festivals & muhurta A
app.hinducalendar
Daily panchang, festivals, muhurta and birth details, identical to the HinduCalendar Android app.
Art & Culture
51
AstroTune — Vedic astrology (Jyotish)B
io.astrotune
Jyotish charts, vargas, dashas, panchang, transits, matching. Place by name, no API key.
Art & Culture
211
bda-mcp
io.github.BharatDharmaAcademy
Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.
Search Documentation Access
1

Related MCP Servers

mcp-indian-astrology
Art & Culture
Dinesh-Gahlot
A
license
C
quality
B
maintenance
Enables AI assistants to access Indian Vedic astrology services including Panchang, Kundli, matchmaking, and festivals through natural language.
Updated 6 days ago (2026-09-21 12:15 UTC)
128
MIT
StarMeet MCP Server
Education & Learning Tools
edestory
A
license
A
quality
C
maintenance
Provides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.
Updated 2 months ago (2026-07-18 15:22 UTC)
3
35 npm
MIT
astromock-mcp
Research & Data
Anshiika123
A
license
Not graded
quality
C
maintenance
Exposes Vedic astrology tools for birth chart, dasha, transit calculations, and question context analysis.
Updated 2 months ago (2026-07-13 14:50 UTC)
MIT
AstroChalit MCP Server
subhamPoulimaInfotech
A
license
Not graded
quality
C
maintenance
Enables AI assistants to access real-time Vedic astrology data and perform calculations like horoscopes, panchang, matchmaking, and planetary positions via the AstroChalit API.
Updated 13 days ago (2026-09-15 07:24 UTC)
6 npm
ISC

panchangam-mcp

Requirements

Install

Run

Connect an MCP client

Claude Code

Any client that reads an MCP server config

Tools

get_panchangam

get_muhurta

Errors

Hora tools

rasi_hora_table

best_horas

Settings

Development

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-indian-astrology

StarMeet MCP Server

astromock-mcp

AstroChalit MCP Server

`get_panchangam`

`get_muhurta`

`rasi_hora_table`

`best_horas`