Divine API Indian Astrology MCP
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Divine API Indian Astrology MCP What's today's Panchang for Delhi?"
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.
Vedic Astrology MCP Server (Kundli, Panchang) by DivineAPI

The official DivineAPI MCP server for Vedic (Indian) astrology. It lets AI assistants such as Claude, ChatGPT and VS Code agents fetch Panchang, kundli, dasha, dosha and matchmaking data from DivineAPI. Use the hosted server at mcp.divineapi.com, or run this one locally with your DivineAPI API key. Vedic text is available in 8 Indian languages: English (en), Hindi (hi), Bengali (bn), Marathi (ma), Tamil (tm), Telugu (tl), Malayalam (ml) and Kannada (kn). Calculations use the Lahiri ayanamsa. 14-day free trial (credit card required to activate the trial): https://divineapi.com/start-trial
Tools also cover Lal Kitab, Jaimini and Hindu festival dates, returned as JSON (and SVG for charts). Product page: Vedic astrology API.
Hosted server URL:
https://mcp.divineapi.com/indian/mcpOne-click install (adds the hosted server with placeholder credentials):
After installing, replace YOUR_API_KEY and YOUR_AUTH_TOKEN in the server's headers with your own values. In VS Code you can use the inputs version of the config below instead, so the values are stored securely.
Connect in 1 minute
1. Get your credentials. Start the 14-day free trial (credit card required to activate the trial), then copy your API key and auth token from the DivineAPI dashboard.
2. Add the server to your client. The hosted server accepts your credentials in one of two ways:
Request headers:
X-Divine-Api-KeyandX-Divine-Auth-Token(Cursor, VS Code, Claude Code).Sign-in page (OAuth): the client opens a DivineAPI page where you paste the API key and auth token once (Claude.ai and Claude Desktop custom connectors).
Claude.ai and Claude Desktop (custom connector)
Custom connectors added in Claude.ai also appear in Claude Desktop.
Open Customize > Connectors, click + Add, then Add custom connector.
Name:
DivineAPI Vedic Astrology. URL:https://mcp.divineapi.com/indian/mcp. Click Continue.Keep the detected sign-in settings and click Add. When you connect, a DivineAPI sign-in page opens: paste your API key and auth token and click Connect.
If your Claude plan offers request headers for custom connectors, you can instead choose no sign-in and add the two headers X-Divine-Api-Key and X-Divine-Auth-Token.
Team and Enterprise plans: an owner adds the connector under Organization settings > Connectors first. Steps from Claude's custom connector guide.
Cursor
~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"divineapi-indian-astrology": {
"url": "https://mcp.divineapi.com/indian/mcp",
"headers": {
"X-Divine-Api-Key": "YOUR_API_KEY",
"X-Divine-Auth-Token": "YOUR_AUTH_TOKEN"
}
}
}
}VS Code (GitHub Copilot agent mode)
.vscode/mcp.json. VS Code asks for both values on first start and stores them securely:
{
"inputs": [
{ "type": "promptString", "id": "divine-api-key", "description": "DivineAPI API key", "password": true },
{ "type": "promptString", "id": "divine-auth-token", "description": "DivineAPI auth token", "password": true }
],
"servers": {
"divineapi-indian-astrology": {
"type": "http",
"url": "https://mcp.divineapi.com/indian/mcp",
"headers": {
"X-Divine-Api-Key": "${input:divine-api-key}",
"X-Divine-Auth-Token": "${input:divine-auth-token}"
}
}
}
}Claude Code
claude mcp add --transport http divineapi-indian-astrology https://mcp.divineapi.com/indian/mcp \
--header "X-Divine-Api-Key: YOUR_API_KEY" \
--header "X-Divine-Auth-Token: YOUR_AUTH_TOKEN"Run /mcp inside Claude Code to check the connection.
Clients that send only one credential field
If a client can send only a single bearer token and no custom headers, send Authorization: Bearer YOUR_API_KEY:YOUR_AUTH_TOKEN (API key, a colon, then the auth token). The server splits it into the two credentials.
Related MCP server: VedAstro MCP Server
Example prompts
"What is today's Panchang for New Delhi? Include tithi, nakshatra, yoga, karana and Rahu Kaal."
"I was born on 15 March 1990 at 14:30 in Mumbai. Show my D1 and D9 charts and my current Vimshottari dasha."
"Am I Manglik? Is Sadhe Sati active for me right now?"
"Match these two birth charts with Ashtakoot Milan and explain the guna score."
"List the Hindu festivals in Kartik month this year, with dates for Delhi."
"Give me my Lal Kitab planetary positions and the debts (rin) in my chart."
Tool groups
The table groups the tools defined in server.py. The hosted server is updated more often and can offer more tools; your MCP client always shows the live list.
Group | What they cover |
Panchang |
|
Panchang extended | Choghadiya, Nivas and Shool, Ritu and Anaya, Samvat, Chandrabalam and Tarabalam, other calendars and epoch, sun and moon rise/set |
Timings | Auspicious timings (muhurat), inauspicious timings, Gowri Panchangam |
Event muhurats | Marriage, business start, house entering, foundation laying, property purchase and vehicle purchase muhurats, Hora, Do Ghati, Jain Pachakkhan |
Kundli basics | Basic astro details, planetary positions, divisional charts ( |
Doshas | Manglik dosha, Kaal Sarpa yoga, Pitra dosha, Sadhe Sati |
Dasha | Vimshottari dasha, Maha / Antar / Pratyantar dasha analysis, Yogini dasha, Kaal Chakra dasha |
Yogas and strengths | Yogas, Nav Pancham yoga, Shadbala, composite friendship, Ghata Chakra, Sudarshana Chakra, Panchak Rahita, gemstone suggestion, Rudraksha suggestion |
Ashtakvarga | Bhinnashtakvarga, Prasthara Chakra, Sarvashtakavarga |
Sub planets (Upagrahas) | Sub-planet positions, sub-planet chart |
Jaimini | Chara dasha, Karakamsha Lagna, Swamsa chart, Padas (Arudha), Jaimini planetary positions and karakas |
KP (Krishnamurti Paddhati) | KP planetary positions, cuspal chart, cuspal sub lords and planetary sub lords (with KP conjunctions and aspects), planetary-cuspal significator table |
Transits | Kundli transit from ascendant and from Moon, Grah Gochar, planet combustion, nakshatra and retrograde transits |
Matchmaking (Kundli Milan) | Ashtakoot Milan, Dashakoot Milan, matching Manglik, basic astro, charts, Vimshottari dasha and planetary positions for both people |
Festivals | Festivals by date, by English month, by Hindu month, find a festival, Malayalam, Tamil and Sankranti festivals |
Lal Kitab | Planetary positions, chart, house positions, conjunctions, teva, planet analysis, dasha, planet types, mahadasha and antardasha content, debts, house signification, Varsha Pravesh, varshphal positions, Muntha and chart |
Varshphal (Tajika annual chart) | Varsha Pravesh, basic details, annual chart, planetary positions and strengths, Muntha, Panchadhikari, Sahams, Tajika aspects, yogas, Tri-Pataki Chakra, Mudda, Patyanini and Yogini dashas |
Kundli analysis | Vargottama planets, Bhava Bala, Ashtama Shani, bhava analysis, bhava group predictions, planet remedies |
Monthly lists | Chandramasa list, month nakshatra list, sunrise and sunset list, Surya nakshatra list, tithi list |
Location | Place search ( |
All tools are read-only (readOnlyHint: true) and each tool call makes one request to the DivineAPI REST API on the astroapi-1, astroapi-2, astroapi-3 or astroapi-8 host.
Inputs the model needs to know
Dates are separate
day,month,yearfields (plushour,min,secfor birth charts; sendsecas0if unknown).placeis a plain lowercase city string;latandlonare decimals.tzoneis a decimal UTC offset, for example5.5for India. Never+5:30.Calculations are sidereal with the Lahiri ayanamsa.
lansets the response language. Vedic responses support 8 Indian languages with DivineAPI's own codes:
Language | Code | Language | Code |
English |
| Tamil |
|
Hindi |
| Telugu |
|
Bengali |
| Malayalam |
|
Marathi |
| Kannada |
|
Self-hosting
You only need this if you want to run the server yourself instead of using the hosted URL. The server reads your credentials from two environment variables: DIVINE_API_KEY and DIVINE_AUTH_TOKEN.
Local (stdio) with uv or pip
# uv (no install step)
uvx divineapi-indian-astrology-mcp
# or pip
pip install divineapi-indian-astrology-mcp
divineapi-indian-astrology-mcpClaude Desktop local config (claude_desktop_config.json; on macOS ~/Library/Application Support/Claude/, on Windows %APPDATA%\Claude\):
{
"mcpServers": {
"divineapi-indian-astrology": {
"command": "uvx",
"args": ["divineapi-indian-astrology-mcp"],
"env": {
"DIVINE_API_KEY": "YOUR_API_KEY",
"DIVINE_AUTH_TOKEN": "YOUR_AUTH_TOKEN"
}
}
}
}The PyPI package can be newer than the code in this repository. To run exactly this repository's code:
git clone https://github.com/DivineAPI/mcp-indian-astrology.git
cd mcp-indian-astrology
pip install .
DIVINE_API_KEY=YOUR_API_KEY DIVINE_AUTH_TOKEN=YOUR_AUTH_TOKEN divineapi-indian-astrology-mcpRemote (streamable HTTP) with Docker
docker build -t divineapi-indian-mcp .
docker run -p 8000:8000 -e MCP_JWT_SECRET=a-long-random-string divineapi-indian-mcpThe MCP endpoint is then http://localhost:8000/mcp. Clients send their own X-Divine-Api-Key and X-Divine-Auth-Token headers. docker compose up maps the same server to port 8001.
Variable | Used for |
| Your DivineAPI credentials. Required in stdio mode; in HTTP mode, per-request headers or the sign-in page override them |
|
|
| Public host name for the OAuth sign-in flow and allowed hosts (default |
| Secret that signs session tokens. Set a fixed value so sign-ins survive restarts |
The OAuth sign-in flow expects HTTPS on MCP_HOST behind a reverse proxy that serves the server under /indian/ (see nginx.conf). Header authentication works without it.
Which plan includes this
The tools call the Vedic endpoints, so they use your Vedic plan (Vedic Sampoorna, Vedic Ananta or Vedic Prakash); a tool works when your plan includes its endpoint. Compare plans at divineapi.com/pricing.
FAQ
Do I need a DivineAPI account to use the Vedic tools? Yes. Each panchang, kundli or matching tool sends your API key and auth token to the Vedic REST endpoints. Start with the 14-day free trial (credit card required to activate the trial); plans and prices are at divineapi.com/pricing.
Can Claude Desktop or Cursor ask for a kundli directly?
Yes. Any client that supports remote MCP over streamable HTTP (Claude.ai, Claude Desktop, Claude Code, Cursor, VS Code) can call the kundli and panchang tools from a plain-language prompt. A client that only starts local servers can run divineapi-indian-astrology-mcp over stdio (see Self-hosting).
Why does my client show Vedic tools that are not in the table?
The table follows this repository's server.py. The hosted server and the PyPI package can be newer than this code, and your client always shows the live list.
Which ayanamsa and zodiac does it use? Sidereal zodiac with the Lahiri ayanamsa, calculated with Swiss Ephemeris.
Can it draw charts?
Yes. Chart tools (divine_get_horoscope_chart, divine_get_sub_planet_chart, the Lal Kitab and matching chart tools) return an SVG plus a base64 image.
I want the REST API, not MCP.
Call the same Vedic endpoints over plain HTTP with the kundli-api and panchang-api quickstarts or the API reference. SDKs: pip install divineapi, npm install divineapi, composer require divineapi/divineapi.
Related repos
Repo | What it is |
Kundli REST API quickstart | |
Kundli matching (Ashtakoot, Dashakoot) REST API | |
Lal Kitab REST API | |
Panchang REST API quickstart | |
Hindu festival dates REST API | |
Overview of all DivineAPI domains | |
Western astrology MCP server | |
Horoscope, tarot and numerology MCP server | |
Python SDK ( | |
Node.js / TypeScript SDK ( | |
PHP SDK ( |
Support
MCP overview: divineapi.com/mcp
API reference: developers.divineapi.com/indian-api
Help center: support.divineapi.com
API status: status.divineapi.com
License
MIT. See LICENSE.
Available Tools
131 toolsdivine_find_festivalARead-onlyIdempotent
Find the date(s) of a specific festival in a given year.
Returns the date or dates on which the named festival falls in the specified year, with location-adjusted timing and festival details.
Inputs: params (required), festival (required). Returns: result
divine_get_antar_dasha_analysisARead-onlyIdempotent
Get textual interpretation of an Antar Dasha (Maha→Antar) period.
No birth data needed — this endpoint returns a generic interpretation for the named Maha + Antar combination.
Inputs: maha_dasha (required), antar_dasha (required), lan. Returns: result
divine_get_ascendant_reportBRead-onlyIdempotent
Get a detailed report based on the ascendant (Lagna) sign.
Returns personality traits, physical characteristics, and life tendencies based on the rising sign at the time of birth.
Inputs: params (required). Returns: result
divine_get_ashtakoot_milanARead-onlyIdempotent
Perform Ashtakoot Milan (8-point compatibility matching) for two people.
The most popular matching method in North India. Evaluates 8 Gunas: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi (max 36).
Inputs: params (required). Returns: result
divine_get_ashtakvargaARead-onlyIdempotent
Get Bhinnashtakvarga (individual Ashtakvarga) tables for all planets.
Returns the 8x12 benefic dots table for each planet showing strength in each sign. Used for transit prediction and sign strength analysis.
Inputs: params (required). Returns: result
divine_get_auspicious_timingsBRead-onlyIdempotent
Get auspicious timings (shubh muhurat) for a given date and location.
Returns favorable time windows for important activities like weddings, house-warming, travel, etc. (Abhijit Muhurat, Amrit Kaal, etc.).
Inputs: params (required). Returns: result
divine_get_basic_astro_detailsARead-onlyIdempotent
Get basic astrological details for a person based on their birth data.
Returns tithi, nakshatra, rashi, sun sign, moon sign, yoga, karana, varna, vashya, yoni, gana, nadi, ayanamsha, and more. vaar is the weekday of birth; with weekday='vedic' a birth before sunrise gets the previous day's vaar.
Inputs: params (required), weekday. Returns: result
divine_get_bhava_analysisBRead-onlyIdempotent
Get the house-by-house (bhava) analysis for a birth chart.
For each of the twelve houses, returns the sign, the house lord and its placement, the occupying planets and the aspects received, each with interpretive content.
Inputs: params (required). Returns: result
divine_get_bhava_group_predictionsBRead-onlyIdempotent
Get predictions grouped by house category for a birth chart.
Returns interpretations for the classical house groups: kendra (angular), trikone (trinal), trishadaya, trik (dusthana), maraka and dhana.
Inputs: params (required). Returns: result
divine_get_bhava_kundliARead-onlyIdempotent
Get Bhava Kundli (house-based chart) for a given bhava chart number.
Unlike the rashi chart which shows sign placements, the Bhava chart shows exact house cusps and planetary positions within houses. Returns the chart as SVG and image. chart_id is a number from 1 to 12.
Inputs: day (required), lat (required), lon (required), min (required), +15 more. Returns: result
divine_get_bhav_balaBRead-onlyIdempotent
Get Bhava Bala (house strength) for a birth chart.
Returns the numeric strength of each of the twelve houses, including the house-lord strength (bhavadhipati bala) and the directional strength (disha bala).
Inputs: params (required). Returns: result
divine_get_chandrabalam_and_tarabalamARead-onlyIdempotent
Get Chandrabalam and Tarabalam for a given date and location.
Chandrabalam is Moon's strength for each rashi. Tarabalam is the auspiciousness based on birth nakshatra. Both important for muhurta selection.
Inputs: params (required). Returns: result
divine_get_chandramasaARead-onlyIdempotent
Get Chandramasa (Hindu lunar month) details for a given date and location.
Returns the current Hindu lunar month name, Purnimant/Amant system, and the start/end dates of the lunar month.
Inputs: params (required), month_type. Returns: result
divine_get_chandramasa_listCRead-onlyIdempotent
Get list of Chandramasa (Hindu lunar months) for a given period.
Returns the start and end dates of each Hindu lunar month for the specified year and location.
Inputs: params (required). Returns: result
divine_get_chandrashtamaARead-onlyIdempotent
Get Chandrashtama periods for a given month and location.
Chandrashtama is when Moon transits through the 8th house from one's birth Moon sign, considered inauspicious for new ventures. Returns the month's periods per moon sign; set day to narrow to a specific date.
Inputs: params (required). Returns: result
divine_get_choghadiyaBRead-onlyIdempotent
Get Choghadiya (auspicious time slots) for a given date and location.
Divides the day and night into multiple slots, each ruled by a different planet, indicating good/bad periods for various activities.
Inputs: params (required). Returns: result
divine_get_composite_friendshipARead-onlyIdempotent
Get composite (Panchda) friendship table for all planets.
Shows natural, temporal, and composite friendship/enmity relationships between all planet pairs in the birth chart.
Inputs: params (required). Returns: result
divine_get_dashakoot_milanARead-onlyIdempotent
Perform Dashakoot Milan (10-point compatibility matching) for two people.
Popular in South India. Evaluates 10 categories with max score of 36. More comprehensive than Ashtakoot Milan.
Inputs: params (required). Returns: result
divine_get_english_calendar_festivalsARead-onlyIdempotent
Get all Hindu festivals for a specific English calendar month.
Returns festivals falling within a given month of the Gregorian calendar.
Inputs: lat (required), lon (required), year (required), month (required), +4 more. Returns: result
divine_get_festivals_by_dateARead-onlyIdempotent
Get festivals falling on a specific date.
Returns all Hindu festivals and observances for a given date and location. Each festival carries a human-readable 'name' unless include_name='NO', localised by 'lan'.
Inputs: params (required). Returns: result
divine_get_festivals_by_monthBRead-onlyIdempotent
Get all Hindu festivals for a specific Hindu calendar month.
Supports all 12 Hindu months: Margashirsha, Pausha, Magha, Phalguna, Chaitra, Vaishakha, Jyeshtha, Ashadha, Shravana, Bhadrapada, Ashvina, Kartika.
Inputs: lat (required), lon (required), year (required), place (required), +4 more. Returns: result
divine_get_gemstone_suggestionARead-onlyIdempotent
Get gemstone recommendations based on the birth chart.
Returns suggested gemstones based on planetary positions, including primary gemstone, alternative stones, and wearing instructions.
Inputs: params (required). Returns: result
divine_get_ghata_chakraARead-onlyIdempotent
Get Ghata Chakra (adverse combinations) for a birth chart.
Returns the inauspicious day, tithi, nakshatra, yoga, karana, and lagna specific to the person's birth nakshatra.
Inputs: params (required). Returns: result
divine_get_gowri_panchangamARead-onlyIdempotent
Get the Gowri Panchangam for a given date and location.
Returns auspicious and inauspicious time segments for the day and night (Laabam, Uthi, etc.) plus Nalla Neram (good time) periods, per the South Indian Gowri Panchangam system.
Inputs: params (required). Returns: result
divine_get_graha_drishtiARead-onlyIdempotent
Get Graha Drishti (Vedic planetary aspects) for a birth chart: which planets aspect which houses and planets.
Parashari drishti on whole-sign houses counted from the Lagna. Every graha aspects the 7th house from itself; Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th, and Rahu and Ketu the 5th and 9th. Covers the nine grahas Sun to Ketu; Uranus, Neptune and Pluto have no drishti and are left out.
Returns planets (name, sign, house, aspects: each with the aspect number, target house, its sign and the planets in it; aspected_by: planet and aspect number) and houses (house, sign, planets in it, aspected_by). Names are returned in English regardless of lan. node_type only changes where Rahu and Ketu fall.
This is not the KP aspect data in divine_get_kp_planetary_sub, which measures aspects in degrees with an orb and gives Rahu and Ketu none.
Inputs: params (required), node_type. Returns: result
divine_get_grah_gocharBRead-onlyIdempotent
Get Grah Gochar (planetary transit) data for a specific planet.
Returns detailed transit information including sign changes, nakshatra transits, and effects on the native.
Inputs: day (required), lat (required), lon (required), min (required), +10 more. Returns: result
divine_get_horoscope_chartBRead-onlyIdempotent
Generate a Vedic horoscope chart (Kundli diagram) as SVG and image.
Supports divisional charts: D1 (Lagna/Rashi), D2 (Hora), D3 (Drekkana), D9 (Navamsha), D10 (Dashamsha), chalit, sun, moon, and more. Optional styling: chart_type (north/south), hex colors, show_* toggles.
Inputs: day (required), lat (required), lon (required), min (required), +18 more. Returns: result
divine_get_inauspicious_timingsBRead-onlyIdempotent
Get inauspicious timings for a given date and location.
Returns unfavorable time windows: Rahu Kaal, Yamaganda, Gulika Kaal, Dur Muhurat. Useful for avoiding inauspicious activities.
Inputs: params (required). Returns: result
divine_get_jaimini_chara_dashaARead-onlyIdempotent
Get Jaimini Chara Dasha periods for a birth chart.
A rashi-based dasha system where signs (not planets) rule the dasha periods. Excellent for timing events in Jaimini astrology.
Inputs: params (required). Returns: result
divine_get_jaimini_karakamsha_lagnaARead-onlyIdempotent
Get Karakamsha Lagna from Jaimini astrology for a birth chart.
The sign occupied by the Atmakaraka in the Navamsha chart. Reveals the soul's desire and spiritual inclinations.
Inputs: params (required), node_type. Returns: result
divine_get_jaimini_padasARead-onlyIdempotent
Get Jaimini Padas (Arudha Padas) for all houses in a birth chart.
Arudha Padas show how the world perceives the native regarding each house signification (wealth, marriage, career, etc.).
Inputs: params (required). Returns: result
divine_get_jaimini_planetary_positionsARead-onlyIdempotent
Get Jaimini-specific planetary positions and karakas.
Returns Chara Karakas (variable significators) like Atmakaraka, Amatyakaraka, etc. based on planetary degrees.
Inputs: params (required), node_type. Returns: result
divine_get_jaimini_swamsa_chartARead-onlyIdempotent
Generate the Jaimini Swamsa chart (Navamsa from the Karakamsha) as SVG and image.
The Navamsa (D9) planets recast into houses with the Karakamsha sign (the Atmakaraka's D9 sign, Atmakaraka from the 7 planets Sun to Saturn) as house 1. divine_get_jaimini_karakamsha_lagna recasts the natal D1 planets around that sign instead. Returns atmakaraka, swamsha_sign and swamsha_sign_no, lagnamsha_sign and lagnamsha_sign_no (the D9 Ascendant), svg, and base64_image. lan translates the names, not the sign numbers; node_type only moves Rahu and Ketu in the chart.
Inputs: params (required), node_type. Returns: result
divine_get_kaal_chakra_dashaBRead-onlyIdempotent
Get Kaal Chakra Dasha periods for a birth chart.
A nakshatra-based dasha system described by Parashar. Each nakshatra pada maps to specific signs creating unique dasha sequences.
Inputs: params (required). Returns: result
divine_get_kaal_sarpa_yogaARead-onlyIdempotent
Check for Kaal Sarpa Yoga in the birth chart.
Occurs when all planets are hemmed between Rahu and Ketu. Returns the type of Kaal Sarpa Yoga and its effects.
Inputs: params (required), node_type. Returns: result
divine_get_karanaARead-onlyIdempotent
Get karana details for a given date and location.
Karana is half of a tithi. There are 11 karanas in Vedic astrology, each with specific qualities for timing activities.
Inputs: params (required). Returns: result
divine_get_kp_cuspalBRead-onlyIdempotent
Get KP Cuspal chart data for a birth chart.
Returns detailed cuspal positions with sign, star, and sub divisions using the KP ayanamsha and unequal house system.
Inputs: params (required). Returns: result
divine_get_kp_cuspal_significatorARead-onlyIdempotent
Get KP Planetary-Cuspal Significator Table.
A comprehensive table showing which houses each planet signifies as star lord and sub lord. Core of KP prediction methodology.
Inputs: params (required), node_type. Returns: result
divine_get_kp_cuspal_subARead-onlyIdempotent
Get KP Cuspal Sub Lords for all house cusps, with the planets aspecting each cusp.
Returns table_data with one row per cusp: the rashi, nakshatra, sub and sub-sub lords, each with the house it sits in and the houses it owns. The sub lord is the primary factor for KP predictions about that house's significations. Each row also has aspected_by, the planets that aspect that cusp.
KP aspects are Vedic aspects measured by degree. Every planet aspects the 7th (180 degrees); Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th. Rahu and Ketu cast no aspect. Orb is 8 degrees (Moon 12; Uranus, Neptune and Pluto 5).
Inputs: params (required). Returns: result
divine_get_kp_planetary_positionsARead-onlyIdempotent
Get KP Planetary Positions for a birth chart.
Returns planetary positions calculated using KP ayanamsha with sign lord, star lord, and sub lord for each planet.
Inputs: params (required), node_type. Returns: result
divine_get_kp_planetary_subARead-onlyIdempotent
Get KP Planetary Sub Lords for all planets, with each planet's conjunctions and aspects.
Returns table_data with one row per planet: the house it sits in and the houses it owns, plus its nakshatra (star), sub and sub-sub lords with theirs. Essential for KP-based event prediction. Each row also has: conjunction (planets within 5 degrees), aspected_by (planets aspecting it), and aspect_to with the planets and house cusps it aspects.
KP aspects are Vedic aspects measured by degree. Every planet aspects the 7th (180 degrees); Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th. Rahu and Ketu cast no aspect. Orb is 8 degrees (Moon 12; Uranus, Neptune and Pluto 5).
Inputs: params (required), node_type. Returns: result
divine_get_kundli_transit_ascendantARead-onlyIdempotent
Get transit analysis from the Ascendant (Lagna) on a chosen transit date.
Shows planetary transits on the given date analyzed from the birth Ascendant, indicating effects on different life areas. Optionally set transit time (hour/min/sec) and chart styling.
Inputs: params (required), transit_day (required), transit_year (required), transit_month (required), +10 more. Returns: result
divine_get_kundli_transit_moonARead-onlyIdempotent
Get transit analysis from the Moon sign on a chosen transit date.
Shows planetary transits on the given date analyzed from the birth Moon sign, the most commonly used transit reference in Vedic astrology. Optionally set transit time (hour/min/sec) and chart styling.
Inputs: params (required), transit_day (required), transit_year (required), transit_month (required), +10 more. Returns: result
divine_get_lal_kitab_antardasha_contentARead-onlyIdempotent
Get textual Lal Kitab interpretation of a Mahadasha-Antardasha combination (no birth data needed).
Returns the Lal Kitab reading for the named period pair. Not every planet pair is valid; the API lists the valid antardashas on mismatch.
Inputs: maha_dasha (required), antar_dasha (required), lan. Returns: result
divine_get_lal_kitab_conjunctionsBRead-onlyIdempotent
Get Lal Kitab planetary conjunctions for a birth chart.
Returns the planet combinations present in the chart and their Lal Kitab interpretation.
Inputs: params (required). Returns: result
divine_get_lal_kitab_dashaCRead-onlyIdempotent
Get Lal Kitab dasha periods for a birth chart.
Returns the Lal Kitab dasha timeline (35-year cycle) with the ruling planet for each period.
Inputs: params (required). Returns: result
divine_get_lal_kitab_debtsARead-onlyIdempotent
Get Lal Kitab debts (rin) for a birth chart.
Returns the karmic debts identified in the chart per Lal Kitab, such as self, mother, relative or unborn debts.
Inputs: params (required). Returns: result
divine_get_lal_kitab_horoscope_chartARead-onlyIdempotent
Generate the Lal Kitab horoscope chart for a birth chart.
Returns the Lal Kitab style chart with planet placements as SVG and image.
Inputs: params (required). Returns: result
divine_get_lal_kitab_house_positionBRead-onlyIdempotent
Get Lal Kitab house positions for a birth chart.
Returns which planets occupy each of the 12 houses in the Lal Kitab system.
Inputs: params (required). Returns: result
divine_get_lal_kitab_house_significationARead-onlyIdempotent
Get the Lal Kitab signification of one house for a birth chart.
Returns what the selected house (1-12) signifies per Lal Kitab and how it plays out in the given chart.
Inputs: params (required), house_no (required). Returns: result
divine_get_lal_kitab_mahadasha_contentARead-onlyIdempotent
Get textual Lal Kitab interpretation of a Mahadasha period (no birth data needed).
Returns the Lal Kitab reading for the named Mahadasha planet. For the sub-period reading, pair with divine_get_lal_kitab_antardasha_content (the antardasha must be valid for this mahadasha; that tool lists the valid options on a mismatch).
Inputs: maha_dasha (required), lan. Returns: result
divine_get_lal_kitab_planet_analysisBRead-onlyIdempotent
Get Lal Kitab analysis of one planet in the birth chart.
Returns the Lal Kitab interpretation of the selected planet's placement, including its condition and effects.
Inputs: params (required), analysis_planet (required). Returns: result
divine_get_lal_kitab_planetary_positionsARead-onlyIdempotent
Get Lal Kitab planetary positions for a birth chart.
Returns planet placements per the Lal Kitab system, the foundation for Lal Kitab analysis and remedies.
Inputs: params (required). Returns: result
divine_get_lal_kitab_planet_typesBRead-onlyIdempotent
Get Lal Kitab planet types for a birth chart.
Classifies each planet per Lal Kitab (e.g. benefic, malefic, sleeping, exalted conditions) for the given chart.
Inputs: params (required). Returns: result
divine_get_lal_kitab_tevaARead-onlyIdempotent
Get Lal Kitab teva (chart conditions) for a birth chart.
Returns which of the Lal Kitab tevas apply to the chart and what each condition means.
Inputs: params (required). Returns: result
divine_get_lal_kitab_varsha_praveshARead-onlyIdempotent
Get the Lal Kitab Varsha Pravesh (annual chart entry) for a chosen year.
Returns the moment the varshphal year begins for the native and the entry chart details. weekday is the day of that moment; with weekday='vedic' a Varsha Pravesh before sunrise gets the previous day.
Inputs: params (required), varshphal_year (required), weekday. Returns: result
divine_get_lal_kitab_varshphal_chartARead-onlyIdempotent
Generate the Lal Kitab varshphal (annual) chart for a chosen year.
Returns the annual chart as SVG and image for the given year.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_lal_kitab_varshphal_munthaARead-onlyIdempotent
Get the Lal Kitab varshphal Muntha for a chosen year.
Returns the Muntha house and its interpretation for the native's annual chart.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_lal_kitab_varshphal_planetary_positionsBRead-onlyIdempotent
Get Lal Kitab varshphal (annual chart) planetary positions for a chosen year.
Returns the planet placements in the annual chart for the given year.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_maha_dasha_analysisBRead-onlyIdempotent
Get textual interpretation of a Maha Dasha period (no birth data needed).
Returns predictions for the named Maha Dasha covering career, health, relationships, and finances.
Inputs: maha_dasha (required), lan. Returns: result
divine_get_malayalam_festivalsARead-onlyIdempotent
Get major Malayalam (Kerala) festivals for a year.
Returns Vishu Kani, Onam, Thrissur Pooram, Guruvayur Ekadashi, Makara Vilakku and other Kerala festivals with dates and images.
Inputs: lat (required), lon (required), year (required), place (required), +3 more. Returns: result
divine_get_manglik_doshaBRead-onlyIdempotent
Check for Manglik Dosha (Mangal Dosha / Kuja Dosha) in the birth chart.
Important for marriage compatibility. Returns Manglik status, percentage, and cancellation factors.
Inputs: params (required). Returns: result
divine_get_matching_basic_astroARead-onlyIdempotent
Get basic astrological details for both persons in matchmaking.
Returns rashi, nakshatra, tithi, gana, nadi, varna, etc. for both P1 and P2 side by side for comparison.
Inputs: params (required). Returns: result
divine_get_matching_horoscope_chartARead-onlyIdempotent
Generate horoscope charts for both persons in matchmaking.
Returns charts for both P1 and P2 for the specified divisional chart type, enabling visual comparison of birth charts.
Inputs: p1_day (required), p1_lat (required), p1_lon (required), p1_min (required), +22 more. Returns: result
divine_get_matching_manglikBRead-onlyIdempotent
Check Manglik Dosha for both people in a matchmaking context.
Compares Manglik status of both individuals to assess marriage compatibility when either person is Manglik.
Inputs: params (required). Returns: result
divine_get_matching_planetary_positionsARead-onlyIdempotent
Get planetary positions for both persons in matchmaking.
Returns side-by-side planetary positions for P1 and P2, useful for detailed compatibility analysis beyond standard matching scores.
Inputs: params (required). Returns: result
divine_get_matching_vimshottari_dashaARead-onlyIdempotent
Get Vimshottari Dasha for both persons in matchmaking.
Returns dasha periods for both P1 and P2 to compare planetary periods and assess timing compatibility.
Inputs: params (required). Returns: result
divine_get_month_nakshatra_listARead-onlyIdempotent
Get daily nakshatra list for a given month.
Returns the nakshatra for each day of the specified month, with start/end times and nakshatra lord details.
Inputs: params (required), nakshatra_pada. Returns: result
divine_get_month_sunrise_sunset_listBRead-onlyIdempotent
Get daily sunrise and sunset times for a given month.
Returns sunrise and sunset times for each day of the specified month at the given location.
Inputs: params (required). Returns: result
divine_get_month_surya_nakshatra_listARead-onlyIdempotent
Get daily Surya (Sun) Nakshatra list for a given month.
Returns the Sun's nakshatra position for each day of the month, useful for solar-based calendar calculations.
Inputs: params (required). Returns: result
divine_get_month_tithi_listBRead-onlyIdempotent
Get daily tithi list for a given month.
Returns the tithi for each day of the specified month with start/end times, paksha, and associated details.
Inputs: params (required). Returns: result
divine_get_muhurat_business_startBRead-onlyIdempotent
Get the Business Start Muhurat for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_do_ghatiBRead-onlyIdempotent
Get the Do Ghati Muhurat for a given date and location.
Returns auspicious timings for the day with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_foundation_layingARead-onlyIdempotent
Get the Foundation Laying (Bhoomi Pujan) Muhurat for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_horaBRead-onlyIdempotent
Get the Hora (planetary hour) timings for a given date and location.
Returns auspicious timings for the day with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_house_enteringARead-onlyIdempotent
Get the Griha Pravesh (house-entering) Muhurat for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_jain_pachakkhanBRead-onlyIdempotent
Get the Jain Pachakkhan timings for a given date and location.
Returns auspicious timings for the day with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_marriageARead-onlyIdempotent
Get the Marriage Muhurat (auspicious wedding dates) for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_property_purchaseARead-onlyIdempotent
Get the Property Purchase Muhurat for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_muhurat_vehicle_purchaseBRead-onlyIdempotent
Get the Vehicle Purchase Muhurat for a given month and location.
Returns auspicious dates in the month with muhurat details.
Inputs: params (required). Returns: result
divine_get_nakshatraBRead-onlyIdempotent
Get nakshatra (lunar mansion) details for a given date and location.
Returns the current nakshatra, its start/end time, lord, and related details.
Inputs: params (required). Returns: result
divine_get_nivas_and_shoolBRead-onlyIdempotent
Get Nivas and Shool (directional inauspicious timings) for a date and location.
Shool indicates inauspicious directions for travel on specific days. Nivas shows the resting place of certain deities.
Inputs: params (required). Returns: result
divine_get_other_calendars_and_epochCRead-onlyIdempotent
Get dates in other calendar systems and epoch values for a given date.
Returns conversions to Vikram Samvat, Shaka Samvat, Kali Yuga, and Julian day numbers.
Inputs: params (required). Returns: result
divine_get_panchak_rahitaARead-onlyIdempotent
Check Panchak status for a given date and location.
Panchak is a 5-nakshatra period (Dhanishta to Revati) considered inauspicious for certain activities like construction and travel.
Inputs: params (required). Returns: result
divine_get_panchangBRead-onlyIdempotent
Get the complete daily Panchang for a given date and location.
Returns comprehensive Vedic calendar data including tithi, nakshatra, yoga, karana, sunrise/sunset, moonrise/moonset, rahu kaal, and more.
Inputs: params (required). Returns: result
divine_get_pitra_doshaBRead-onlyIdempotent
Check for Pitra Dosha (ancestral affliction) in the birth chart.
Indicates karmic debts from ancestors affecting family harmony, progeny, and prosperity. Returns remedial measures.
Inputs: params (required). Returns: result
divine_get_planet_analysisARead-onlyIdempotent
Get detailed analysis of one planet in the birth chart.
Returns interpretation of the selected planet's placement including house lordship, aspects, conjunctions, strengths, and effects.
Inputs: params (required), analysis_planet (required). Returns: result
divine_get_planetary_positionsBRead-onlyIdempotent
Get planetary positions in the birth chart (Kundli).
Returns positions of all 9 Vedic planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) with sign, degree, nakshatra, and house placement.
Inputs: params (required), node_type. Returns: result
divine_get_planet_combustion_transitBRead-onlyIdempotent
Get planet combustion (Asta) transit details for a specific planet.
Combustion occurs when a planet is too close to the Sun and loses strength. Returns combustion periods and their effects.
Inputs: day (required), lat (required), lon (required), min (required), +10 more. Returns: result
divine_get_planet_nakshatra_transitARead-onlyIdempotent
Get nakshatra transit details for a specific planet.
Returns when the planet enters and exits each nakshatra, useful for fine-tuning transit predictions.
Inputs: day (required), lat (required), lon (required), min (required), +10 more. Returns: result
divine_get_planet_remediesARead-onlyIdempotent
Get remedial measures for one planet's placement in the birth chart.
For the selected planet, returns the recommended donation, gemstone, lifestyle practice and mantra, plus the weaknesses the remedy addresses.
Inputs: params (required), analysis_planet (required). Returns: result
divine_get_planet_retrograde_transitBRead-onlyIdempotent
Get retrograde transit details for a specific planet.
Returns retrograde and direct motion periods for the planet, along with their effects on the native.
Inputs: day (required), lat (required), lon (required), min (required), +10 more. Returns: result
divine_get_prasthara_chakraARead-onlyIdempotent
Get Prasthara Chakra (expanded Ashtakvarga) for a birth chart.
Shows the detailed breakdown of benefic contributions from each planet to every sign in the Ashtakvarga system.
Inputs: params (required). Returns: result
divine_get_pratyantar_dasha_analysisARead-onlyIdempotent
Get textual interpretation of a Pratyantar Dasha (Maha→Antar→Pratyantar) period.
No birth data needed — generic interpretation for the named three-planet combination.
Inputs: maha_dasha (required), antar_dasha (required), pratyantar_dasha (required), lan. Returns: result
divine_get_ritu_and_anayaBRead-onlyIdempotent
Get Ritu (season) and Anaya details for a given date and location.
Returns the current Hindu season (Vasant, Grishma, Varsha, Sharad, Hemant, Shishir) and related calendar information.
Inputs: params (required). Returns: result
divine_get_rudraksha_suggestionARead-onlyIdempotent
Get Rudraksha (mukhi bead) suggestions for a person based on their birth data.
Returns the recommended life, lucky, and dasha Rudraksha beads.
Inputs: params (required). Returns: result
divine_get_sadhe_satiARead-onlyIdempotent
Check Sadhe Sati (Saturn transit) status for the person.
The 7.5-year period of Saturn transiting through the 12th, 1st, and 2nd houses from Moon sign. Returns current phase and dates.
Inputs: params (required). Returns: result
divine_get_samvatBRead-onlyIdempotent
Get Samvat (Hindu calendar year) details for a given date and location.
Returns the current Vikram Samvat, Shaka Samvat year names and numbers.
Inputs: params (required). Returns: result
divine_get_sankranti_festivalsBRead-onlyIdempotent
Get Sankranti festivals for a year.
Returns the twelve solar Sankranti transitions (Makar, Kumbha, Meena, Mesha, and so on) with dates, transition moments, and punya kala (auspicious) windows.
Inputs: lat (required), lon (required), year (required), place (required), +3 more. Returns: result
divine_get_sarvashtakavargaARead-onlyIdempotent
Get Sarvashtakavarga (combined Ashtakvarga) for a specific chart.
The sum of all individual Ashtakvarga tables, showing overall strength of each sign. Key for transit predictions.
Inputs: day (required), lat (required), lon (required), min (required), +10 more. Returns: result
divine_get_shadbalaBRead-onlyIdempotent
Get Shadbala (six-fold planetary strength) for a birth chart.
Calculates six types of strength: Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, and Drik Bala for each planet.
Inputs: params (required). Returns: result
divine_get_shani_ashtam_shaniARead-onlyIdempotent
Get the Ashtama Shani (shani ashtam shani) analysis for a birth chart.
Returns the periods when transiting Saturn occupies the eighth house from natal Saturn, together with the natal Saturn placement, the ashtama sign and age-banded predictive content.
Inputs: params (required). Returns: result
divine_get_sub_planet_chartARead-onlyIdempotent
Generate a sub-planet (Upagraha) chart as SVG and image.
Returns a visual chart showing the placement of sub-planets (Dhuma, Vyatipata, Parivesha, etc.) in North or South Indian style.
Inputs: day (required), lat (required), lon (required), min (required), +14 more. Returns: result
divine_get_sub_planet_positionsBRead-onlyIdempotent
Get sub-planet (Upagraha) positions for a birth chart.
Returns positions of sub-planets like Dhuma, Vyatipata, Parivesha, Indra Chapa, and Upaketu with sign, degree, and nakshatra details.
Inputs: params (required). Returns: result
divine_get_sudarshana_chakraBRead-onlyIdempotent
Get Sudarshana Chakra for a birth chart.
Overlays Lagna, Moon, and Sun charts concentrically for comprehensive life prediction year by year.
Inputs: params (required). Returns: result
divine_get_sun_moonBRead-onlyIdempotent
Get sun and moon rise/set timings for a given date and location.
Returns sunrise, sunset, moonrise, moonset times and related astronomical data.
Inputs: params (required). Returns: result
divine_get_surya_nakshatraBRead-onlyIdempotent
Get Surya (Sun) Nakshatra details for a given date and location.
Returns the nakshatra occupied by the Sun, useful for solar-based astrological calculations and rashi sandhi analysis.
Inputs: params (required). Returns: result
divine_get_tamil_festivalsBRead-onlyIdempotent
Get major Tamil festivals for a year.
Returns Thai Pongal, Puthandu (Tamil New Year), Karthigai Deepam, Vaikuntha Ekadashi, Arudra Darshan and other Tamil festivals with dates and images.
Inputs: lat (required), lon (required), year (required), place (required), +3 more. Returns: result
divine_get_tithiBRead-onlyIdempotent
Get tithi (lunar day) details for a given date and location.
Returns the current tithi, paksha (Shukla/Krishna), start/end times, and deity.
Inputs: params (required). Returns: result
divine_get_uday_lagnaARead-onlyIdempotent
Get Uday Lagna (rising sign) timings for a given date and location.
Returns the lagna (ascendant sign) rising periods across the day, with sunrise and sunset times. Needs only date and location; birth details are not used by this endpoint.
Inputs: params (required). Returns: result
divine_get_vargottama_planetsARead-onlyIdempotent
Get the vargottama planets for a birth chart.
Returns each planet with its D1 (birth) and D9 (navamsha) sign and whether it is vargottama (the same sign in both charts), a placement that is considered a source of strength.
Inputs: params (required). Returns: result
divine_get_varshphal_basic_astro_detailsARead-onlyIdempotent
Get the Varshphal Basic Astro Details (annual chart) for the given year and birth data.
vaar is the weekday of the Varsha Pravesh moment; with weekday='vedic' a moment before sunrise gets the previous day's vaar.
Inputs: params (required), varshphal_year (required), weekday. Returns: result
divine_get_varshphal_horoscope_chartARead-onlyIdempotent
Get the Varshphal (annual) divisional horoscope chart (D1..D60) as SVG for the given year.
Inputs: params (required), varshphal_year (required), chart_id. Returns: result
divine_get_varshphal_mudda_dashaBRead-onlyIdempotent
Get the Varshphal Mudda Dasha (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_munthaBRead-onlyIdempotent
Get the Varshphal Muntha (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_panchadhikariCRead-onlyIdempotent
Get the Varshphal Panchadhikari (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_patyanini_dashaBRead-onlyIdempotent
Get the Varshphal Patyanini Dasha (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_planetary_positionsBRead-onlyIdempotent
Get the Varshphal Planetary Positions (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_planetary_strengthsBRead-onlyIdempotent
Get the Varshphal Planetary Strengths (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_sahamsBRead-onlyIdempotent
Get the Varshphal Sahams (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_tajika_aspectBRead-onlyIdempotent
Get the Varshphal Tajika Aspect (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_tri_pataki_chakraARead-onlyIdempotent
Get the Varshphal Tri Pataki Chakra (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_varsha_praveshBRead-onlyIdempotent
Get the Varshphal Varsha Pravesh (annual chart) for the given year and birth data.
Returns varshphal_year, age, varsha_pravesh (the moment the year begins) and weekday; with weekday='vedic' a Varsha Pravesh before sunrise gets the previous day.
Inputs: params (required), varshphal_year (required), weekday. Returns: result
divine_get_varshphal_yogasCRead-onlyIdempotent
Get the Varshphal Yogas (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_varshphal_yogini_dashaARead-onlyIdempotent
Get the Varshphal Yogini Dasha (annual chart) for the given year and birth data.
Inputs: params (required), varshphal_year (required). Returns: result
divine_get_vimshottari_dashaARead-onlyIdempotent
Get Vimshottari Dasha periods for a birth chart at the requested granularity.
The most widely used dasha system. Pick dasha_type to drill from Maha down
to Deha. For Prana/Deha, also specify the parent planet(s).
To interpret a running period in prose, pass its planet(s) to
divine_get_maha_dasha_analysis, divine_get_antar_dasha_analysis, or
divine_get_pratyantar_dasha_analysis (those need no birth data).
Inputs: params (required), dasha_type (required), maha_dasha, antar_dasha. Returns: result
divine_get_yoga_panchangBRead-onlyIdempotent
Get yoga (Sun-Moon angular relationship) for a given date and location.
Returns the current yoga from the 27 Nitya Yogas, each indicating auspicious or inauspicious qualities for the day.
Inputs: params (required). Returns: result
divine_get_yogasARead-onlyIdempotent
Get all yogas (planetary combinations) present in the birth chart.
Returns special planetary combinations indicating specific life outcomes: wealth (Dhana Yoga), fame (Raja Yoga), spiritual growth, etc.
Inputs: params (required). Returns: result
divine_get_yogini_dashaCRead-onlyIdempotent
Get Yogini Dasha periods for a birth chart.
An alternative dasha system based on 8 Yoginis with a 36-year cycle. Popular for quick predictions and event timing.
Inputs: params (required). Returns: result
divine_search_locationARead-onlyIdempotent
Search for a place by name and get its coordinates and timezone, for the place, lat, lon and tzone inputs of the other tools.
Returns up to 10 matches, largest population first, each with place_id, name, full_name (e.g. 'Patna, Bihar, India'), country, admin1 (state or region), latitude, longitude, timezone (IANA name, e.g. Asia/Kolkata), timezone_value (UTC offset in hours) and population. Matching is by name prefix. When several places match, confirm with the user which one is meant.
timezone_value is the zone's offset today. For a birth date in a zone with summer time (most of the Americas and Europe) or with historical changes, the offset on that date can differ (New York is -5 in winter and -4 in summer), so work out the offset for the birth date from the IANA timezone before passing it as tzone.
Place data (c) GeoNames (geonames.org), CC BY 4.0: keep the attribution when showing results.
Inputs: place (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 131 tools
Most tools map to distinct astrology subsystems and the descriptions are unusually detailed, so many close calls are resolvable. However, there is real overlap: get_panchang returns tithi/nakshatra/yoga/karana that dedicated tools also expose, and the transit/muhurat areas split into generic plus specialized variants. With 131 tools, an agent still faces meaningful selection risk.
Tool names follow a highly predictable snake_case pattern with a consistent divine_ prefix and verb_noun structure (get_, find_, search_). The few non-get verbs still fit the same scheme. This makes the naming very easy to scan and reason about.
131 tools is far beyond a navigable MCP surface, even for a broad astrology domain. Many families (Lal Kitab, Varshphal, muhurat, festival, panchang components) could be consolidated into parameterized tools rather than exposed individually. The count creates substantial navigation and context overhead.
The surface is extremely comprehensive: natal charts, multiple dasha systems, transits, panchang, festivals, matching, muhurat, KP, Jaimini, Ashtakvarga, Lal Kitab, and varshphal are all covered. Obvious gaps are minimal for the stated Vedic astrology purpose.
Maintenance
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
An MCP server that integrates with Discord to provide AI-powered features.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceWorld's first Vedic Astrology MCP Server — connect Claude, ChatGPT, Cursor, or any AI to real Vedic astrology. Provides horoscope predictions, compatibility matching, numerology, planetary positions, yogas and house analysis via MCP.11-
- AlicenseAqualityDmaintenanceVedic astrology MCP server providing 6 tools: horoscope predictions (200+ life aspects), compatibility match reports with Kuta scoring, Chaldean numerology, raw planet and house chart data, 24 general astro properties, and Ashtakvarga charts. Free tier included with no API key required, premium unlimited tier also available3682MIT
- FlicenseNot gradedqualityDmaintenanceAn AI astrology MCP server providing 49 tools for Western and Vedic astrology calculations, including natal charts, dashas, transits, and compatibility analysis, powered by Swiss Ephemeris.-
- AlicenseAqualityDmaintenanceAn MCP server that provides computed planetary positions using the Swiss Ephemeris engine, validated against JPL Horizons to under one arcsecond. It enables AI assistants to answer astrology and astronomy questions with real, never-guessed data.1974 npmPolyForm Noncommercial 1.0.0