astro-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
astro-mcp
An MCP server for Vedic astrology and panchang calculations, powered by PyJHora and the Swiss Ephemeris.
Tools
Tool | Returns |
| Sunrise, sunset, vara, tithi, nakshatra, yoga and karana, with start and end times. |
| D1 birth chart: lagna and planets with sign, degree, nakshatra, pada, whole-sign house and retrograde state. |
| Vimshottari mahadasha timeline, the balance at birth, and the mahadasha/antardasha running on a date. |
| Abhijit and Brahma muhurta, Rahu kaalam, Yamagandam, Gulika and Durmuhurtam. |
Related MCP server: Astro Skill MCP Server
Defaults
Location: Varanasi (25.3176 N, 82.9739 E),
Asia/KolkataAyanamsa: Lahiri / Chitrapaksha
Panchang: Drik ganita, sunrise-based day
Sunrise: Hindu rising convention (disc center, no refraction)
Houses: whole sign from lagna
Months and festivals (when added): purnimanta
Every tool accepts latitude, longitude, timezone (an IANA name or a fixed
UTC offset in hours) and location_name to override the defaults.
Install
Requires Python 3.12 or newer.
python3.12 -m venv .venv
.venv/bin/pip install -e .With uv:
uv venv --python 3.12
uv pip install -e .The server speaks MCP over stdio:
.venv/bin/astro-mcpConfigure
Point any MCP client at the installed executable:
{
"mcpServers": {
"astro-mcp": {
"command": "/absolute/path/to/astro-mcp/.venv/bin/astro-mcp"
}
}
}Examples
get_panchang:
{"date": "2026-11-20"}{
"sunrise": "2026-11-20T06:22:30+05:30",
"tithi": {
"name": "Dashami",
"paksha": "Shukla",
"start": "2026-11-19T07:31:30+05:30",
"end": "2026-11-20T07:16:50+05:30"
},
"nakshatra": {
"name": "Purva Bhadrapada",
"pada": 4,
"start": "2026-11-19T06:10:35+05:30",
"end": "2026-11-20T06:56:46+05:30"
}
}get_kundli:
{"date": "1990-01-01", "time": "12:00"}get_dashas (defaults as_of to today):
{"date": "1990-01-01", "time": "12:00", "as_of": "2026-11-20"}get_muhurta:
{"date": "2026-11-20"}Birth times use 24-hour HH:MM. Dates use YYYY-MM-DD.
Test
.venv/bin/pytestLicense and attribution
AGPL-3.0-or-later. See LICENSE.
This server calls PyJHora (AGPL-3.0) and Swiss Ephemeris through pyswisseph (AGPL-3.0, or a commercial license from Astrodienst). If you run a modified version as a network service, AGPL section 13 requires you to offer the corresponding source to its users.
Astrology output is for cultural and informational purposes. It is not medical, legal or financial advice.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Professional Vedic astrology tools for AI agents via MCP.
78 astrology calculations, Tarot, symbolic readings and Vedic calendars via two scoped MCP tools.
Vedic astrology MCP: panchanga, kundli matching, muhurta, dashas.
Vedic kundli, panchang, dashas, nakshatras and KP charts for AI agents, one API key.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables compute of live Vedic astrology birth charts, dashas, kundali matches, and AI readings via 22 real API tools.229 npm1MIT
- AlicenseAqualityCmaintenanceProvides Vedic astrology calculations (kundali, dasha, panchang, yoga) and Hindi/English PDF reports via 11 MCP tools, with SQLite-backed client/report storage.113MIT
- AlicenseAqualityCmaintenanceHosted Streamable HTTP MCP server for Vedic astrology: panchang, kundali (birth chart), matchmaking, dashas, doshas, muhurta and 16 tools computed by a precision astronomy engine.1759 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server for Indian astrology (Jyotisha) that provides deterministic Lahiri sidereal calculations, question-aware natal context, Vimshottari dasha, and current gochara, enabling natural language conversations about astrology with saved birth profiles.-