AstroChalit MCP Server
Click 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., "@AstroChalit MCP Server What is the daily horoscope for Aries?"
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.
AstroChalit MCP Server
Official Model Context Protocol (MCP) server for the AstroChalit / Vedic Astrology API suite.
This server allows AI assistants (like Claude Desktop, Cursor, Windsurf, and any MCP-compliant client) to natively query real-time Vedic astrology calculations, horoscopes, Kundli (natal birth charts), Panchang, matchmaking, Dashas, and Numerology directly via natural language.
NPM Package: https://www.npmjs.com/package/astrochalit-mcp
API Documentation & Keys: https://www.vedicastrologyapi.com
Prerequisites
Node.js: v18.0.0 or higher
AstroChalit / VedicAstrologyAPI Key: Get an API key from vedicastrologyapi.com
Related MCP server: mcp-indian-astrology
Installation & Configuration
1. Claude Desktop
Open your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add
astrochalitto yourmcpServersconfiguration:
{
"mcpServers": {
"astrochalit": {
"command": "npx",
"args": ["-y", "astrochalit-mcp"],
"env": {
"ASTROCHALIT_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Restart Claude Desktop.
2. Cursor (AI Code Editor)
Navigate to Cursor Settings → Features → MCP Servers.
Click + Add New MCP Server.
Fill in the details:
Name:
astrochalitType:
commandCommand:
npx -y astrochalit-mcp
Set the environment variable
ASTROCHALIT_API_KEY=YOUR_API_KEY_HERE.
Example Usage Prompts
Once configured, simply talk to your assistant in natural language:
"What is today's horoscope for Aries?"
"Calculate the Lagna and Navamsha chart for someone born on 15 August 1995 at 14:30 in New Delhi, India."
"Calculate the Sun chart (Surya Kundli) and Moon chart (Chandra Kundli) for birth details 15 August 1995 at 14:30 in New Delhi."
"Check marriage compatibility between a male born 12-05-1992 in Mumbai and a female born 24-08-1994 in Pune."
"What are the current Chaughadiya and Rahu Kaal timings for Delhi today?"
"Calculate the current Vimshottari Dasha period for my birth details."
"Generate a complete numerology reading for John Doe born on 1990-11-20."
Your assistant will automatically select and call the appropriate tool, fetch the accurate astronomical and astrological calculation, and provide an insightful response.
Available Tools (Over 80+ Astrology Endpoints)
This MCP server provides comprehensive access across the full Vedic astrology system:
1. Horoscopes & Daily Predictions
get_horoscope- Daily, weekly, monthly, and yearly horoscopes for all 12 signs.
2. Panchang & Muhurtas
get_panchang- Tithi, Vaar, Nakshatra, Yoga, Karana, Sunrise, Sunset.get_chaugadiya_muhurta- Auspicious and inauspicious daytime and nighttime periods.get_hora_muhurta- Hourly planetary planetary rulerships.get_hindu_festivals- Upcoming Hindu calendar festivals and tithis.
3. Birth Charts & Divisional Charts (Vargas)
get_divisional_chart_d1(Lagna Chart / Rashi)get_divisional_chart_d2(Hora - Wealth)get_divisional_chart_d3(Drekkana - Siblings)get_divisional_chart_d7(Saptamsha - Children)get_divisional_chart_d9(Navamsha - Marriage & Dharma)get_divisional_chart_d10(Dashamsha - Career & Profession)get_divisional_chart_d12throughget_divisional_chart_d60(Shashtiamsha)get_sun_chart(Surya Kundli / Sun as Ascendant - Soul, Vitality, Authority, Career)get_moon_chart(Chandra Kundli / Moon as Ascendant - Mind, Emotions, Transit Gochar Reference)
4. Matchmaking & Compatibility (Kundli Milan)
get_ashtakoot- 36-point Guna Milan matching analysis.get_dashakoot- South Indian 10-koota compatibility analysis.get_manglik_report- Manglik Dosha detection and cancellation rules.get_compatibility_check- Zodiac sign harmony and relationship advice.get_match_birthchart- Comparative birth chart analysis.
5. Dashas (Planetary Periods)
get_current_vdasha&get_current_vdasha_all- Current Vimshottari Mahadasha, Antardasha, and Pratyantardasha.get_major_vdasha- Complete lifetime planetary periods.get_chardasha_current&get_major_chardasha- Jaimini Char Dasha periods.get_yoginidasha_major- Yogini Dasha timings.
6. Numerology
get_numerologyreport- Complete numerology report (Radical, Destiny, Name numbers).get_numerologynumbers- Core numerological vibratory numbers.get_lifepath_prediction- Life path guidance and career insights.get_radical_prediction&get_numerology_prediction- Year and destiny predictions.
7. Planetary Mechanics & Transits (Gochar)
get_planetary_position- Exact degrees, nakshatras, retrogrades, and speeds of all planets.get_planet_ingress- Planetary transits into zodiac signs.get_planet_aspects- Planetary aspects and drishti.get_moon_phases- Moon phases and lunar illumination.get_bhinnaashtakvarga&get_sarvashtakvarga- Ashtakvarga bindu calculations.
8. Dosha Analysis & Astrological Remedies
get_kaalsarp_dosha- Kaal Sarp yoga presence, type, and remedies.get_sadesati_dosha- Saturn's 7.5 year transit phases and status.get_pitru_dosha- Ancestral affliction analysis.get_gemstone_suggestion&get_rudraksha_suggestion- Personalized gemstone and rudraksha recommendations based on planetary strength.
Local Development
If you want to run or extend the server locally:
# 1. Clone the repository
git clone https://github.com/subham-poulima/Astroavastha_api.git
# 2. Enter MCP directory
cd Astroavastha_api_mcp
# 3. Install dependencies
npm install
# 4. Build TypeScript
npm run build
# 5. Run locally
ASTROCHALIT_API_KEY=your_key node build/index.jsLicense
ISC License. Built for the developer and AI community by AstroChalit.
Available Tools
83 toolsget_ashtakootC
Execute ashtaKoot AstroChalit API
Inputs: f_day (required), f_lat (required), f_lon (required), f_min (required), +10 more.
get_bhinnaashtakvargaA
Calculate Bhinnashtak Varga (individual planetary score table across all 12 zodiac signs) for a specified planet based on birth details.
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_biorhythmC
Execute biorhythm AstroChalit API
Inputs: dob, dateOfBirth.
get_calculate_ephemerisD
Execute calculate_ephemeris AstroChalit API
Inputs: selectedYear (required), selectedMonthNumber (required), zodiac, timeZone.
get_calculate_planet_ingressC
Execute calculate_planet_ingress AstroChalit API
Inputs: endDate (required), startDate (required), planet, zodiac, +5 more.
get_char_antar_dashaD
Execute char_antar_dasha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_char_maha_dashaD
Execute char_maha_dasha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_char_pratyantar_dashaD
Execute char_pratyantar_dasha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +7 more.
get_compatibility_checkC
Execute compatibility_check AstroChalit API
Inputs: maleSign (required), femaleSign (required).
get_dashakootC
Execute dashaKoot AstroChalit API
Inputs: f_day (required), f_lat (required), f_lon (required), f_min (required), +10 more.
get_divisional_chart_d1D
Execute d1chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d10D
Execute d10chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d11D
Execute d11chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d12C
Execute d12chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d16C
Execute d16chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d2D
Execute d2chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d20D
Execute d20chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d24D
Execute d24chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d27D
Execute d27chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d3D
Execute d3chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d30C
Execute d30chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d4C
Execute d4chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d40D
Execute d40chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d45D
Execute d45chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d5D
Execute d5chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d6D
Execute d6chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d60C
Execute d60chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d601C
Execute d601chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d7D
Execute d7chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d8D
Execute d8chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_divisional_chart_d9D
Execute d9chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_gemstone_suggestionD
Execute gemstone_suggestion AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_get_bala_detailsD
Execute get_bala_details AstroChalit API
Inputs: day (required), bala (required), hour (required), year (required), +6 more.
get_get_chaugadiya_muhurtaD
Execute get_chaugadiya_muhurta AstroChalit API
Inputs: date (required), latitude (required), longitude (required).
get_get_hora_muhurtaC
Execute get_hora_muhurta AstroChalit API
Inputs: date (required), latitude (required), longitude (required).
get_hindu_festivalsB
Execute hindu_festivals AstroChalit API to get festivals for a given month and year
Inputs: year (required), month (required), language.
get_horoscopeC
Execute horoscope AstroChalit API
Inputs: signName (required).
get_jaminiD
Execute jamini AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kaalsarp_doshaD
Execute kaalSarp_dosha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_birthD
Execute kp_birth AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_house_cupsD
Execute kp_house_cups AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_house_significatorsD
Execute kp_house_significators AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_planetsD
Execute kp_planets AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_planet_significatorsD
Execute kp_planet_significators AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_kp_significatorsD
Execute kp_significators AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_lalkitab_chartD
Execute lalkitab_chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_lalkitab_debtsC
Execute lalkitab_debts AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_lalkitab_predictionsC
Execute lalkitab_predictions AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_lifepath_predictionC
Execute lifepath_prediction AstroChalit API
Inputs: fullName (required), dateOfBirth (required), gender.
get_manglik_dosha_reportD
Execute manglik_dosha_report AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_manglik_reportC
Execute manglik_report AstroChalit API
Inputs: f_day (required), f_lat (required), f_lon (required), f_min (required), +10 more.
get_match_birthchartD
Execute match_birthChart AstroChalit API
Inputs: f_day (required), f_lat (required), f_lon (required), f_min (required), +10 more.
get_moon_chartB
Calculate Chandra Kundli (Moon Chart) where the natal Moon is positioned in the 1st House (Ascendant), analyzing mental peace, emotional stability, subconscious patterns, and Gochar transits
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_moon_phasesC
Execute moon_phases AstroChalit API to get moon phases for a selected date/month
Inputs: selectedDate (required).
get_numerologynumbersC
Execute numerologyNumbers AstroChalit API
Inputs: fullName (required), dateOfBirth (required), gender.
get_numerology_predictionD
Execute numerology_prediction AstroChalit API
Inputs: fullName (required), dateOfBirth (required), gender.
get_numerologyreportC
Execute numerologyReport AstroChalit API
Inputs: fullName (required), dateOfBirth (required), gender.
get_panchangD
Execute panchang AstroChalit API
Inputs: date (required), latitude (required), longitude (required), time, +1 more.
get_pitru_doshaD
Execute pitru_dosha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_planetary_positionD
Execute planetary_position AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +8 more.
get_planet_aspectsC
Execute planet_aspects AstroChalit API to get planetary aspects for a month/year
Inputs: year (required), month (required).
get_planet_ingressC
Execute planet_ingress AstroChalit API to get transit/ingress of planets into zodiac signs
Inputs: year (required), month (required), planet, zodiacSystem.
get_radical_predictionC
Execute radical_prediction AstroChalit API
Inputs: fullName (required), dateOfBirth (required), gender.
get_rudraksha_suggestionC
Execute rudraksha_suggestion AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_sadesati_doshaD
Execute sadeSati_dosha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_sarvashtakvargaC
Calculate Sarvashtak Varga (cumulative Ashtakvarga points across all zodiac signs and planets) based on birth details.
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_searchplaceswithnameD
Execute searchPlacesWithName AstroChalit API
Inputs: place (required).
get_sun_chartC
Calculate Surya Kundli (Sun Chart) where the natal Sun is positioned in the 1st House (Ascendant), analyzing physical vitality, soul purpose, authority, and public status
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_varshphal_detailsD
Execute varshphal_details AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_varshphal_harsha_balaD
Execute varshphal_harsha_bala AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_varshphal_month_chartD
Execute varshphal_month_chart AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_varshphal_muddaC
Execute varshphal_mudda AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_varshphal_mudda_antarD
Execute varshphal_mudda_antar AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_varshphal_planetsB
Calculate Varshphal planetary positions and details based on birth details and yearInput, returning solar_return, momentTime, and planetDetails.
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_varshphal_sahamD
Execute varshphal_saham AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_varshphal_year_chartB
Calculate Varshphal Year Chart (Solar Return annual horoscope) based on birth details and yearInput, returning solar_return, momentTime, and planetary positions.
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_vimshottari_antarD
Execute vimshottari_antar AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +6 more.
get_vimshottari_mahaD
Execute vimshottari_maha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_vimshottari_pranaC
Execute vimshottari_prana AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +9 more.
get_vimshottari_pratyantarD
Execute vimshottari_pratyantar AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +7 more.
get_vimshottari_sookshmaD
Execute vimshottari_sookshma AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +8 more.
get_yogini_mahaD
Execute yogini_maha AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
get_yogini_subC
Execute yogini_sub AstroChalit API
Inputs: day (required), hour (required), year (required), month (required), +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 83 tools
Descriptions are near-identical boilerplate ('Execute X AstroChalit API'), so the agent must infer purpose from names alone. Several tools materially overlap: get_manglik_report vs get_manglik_dosha_report, get_compatibility_check vs get_match_birthchart vs get_ashtakoot vs get_dashakoot, get_planet_ingress vs get_calculate_planet_ingress, and get_varshphal_details vs get_varshphal_year_chart vs get_varshphal_planets. The 22 divisional chart tools are distinguishable only by number, which is fine, but the surrounding clusters are not.
Almost all names use a get_ prefix with snake_case, which is broadly predictable. However there are clear breaks: get_get_hora_muhurta and get_get_chaugadiya_muhurta double the prefix, get_searchplaceswithname is a run-together string, and the underlying API names mix snake_case and camelCase (dashaKoot, match_birthChart, sadeSati_dosha).
83 tools is an extreme mismatch for any single server and clearly reflects one wrapper per backend endpoint rather than a designed tool surface. The 22 divisional charts should be one parameterized tool, and the vimshottari/yogini/varshphal sub-levels could be consolidated similarly. This volume forces the agent to scan an enormous list to find the right call.
Coverage of the Vedic astrology domain is genuinely broad: divisional charts, KP, dasha systems, doshas, varshphal, muhurta, transits, numerology, Lal Kitab, gemstones and matching are all present. A few lifecycle gaps exist (no location/place resolution beyond searchPlacesWithName, no explicit chart retrieval/update or saved-profile management), but most workflows can be completed.
Maintenance
Related MCP Connectors
Vedic astrology, Panchang, charts and compatibility for AI assistants. 10 free lifetime calls.
Vedic kundli, panchang, dashas, nakshatras and KP charts for AI agents, one API key.
Vedic and Western astrology for AI agents: charts, dasha, matchmaking, panchanga, numerology, tarot.
Аccess to personalized Enigmata astrological forecasts (day/week/month/thematic) for AI assistants
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables compute of live Vedic astrology birth charts, dashas, kundali matches, and AI readings via 22 real API tools.229 npm1MIT
- AlicenseCqualityBmaintenanceEnables AI assistants to access Indian Vedic astrology services including Panchang, Kundli, matchmaking, and festivals through natural language.128MIT
- AlicenseAqualityFmaintenanceProvides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.3MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to retrieve precise astrology calculations, including natal charts, transits, composites, harmonic midpoints, and ranked daily aspects, using real ephemeris data rather than guesses.51AGPL 3.0