Skip to main content
Glama
AstroChalit MCP Server

AstroChalit MCP Server

AstroChalit MCP Server

npm version npm downloads License: ISC

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.


Prerequisites


Related MCP server: mcp-indian-astrology

Installation & Configuration

1. Claude Desktop

  1. Open your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add astrochalit to your mcpServers configuration:

{
  "mcpServers": {
    "astrochalit": {
      "command": "npx",
      "args": ["-y", "astrochalit-mcp"],
      "env": {
        "ASTROCHALIT_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. Restart Claude Desktop.


2. Cursor (AI Code Editor)

  1. Navigate to Cursor Settings → Features → MCP Servers.

  2. Click + Add New MCP Server.

  3. Fill in the details:

    • Name: astrochalit

    • Type: command

    • Command: npx -y astrochalit-mcp

  4. 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_d12 through get_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.js

License

ISC License. Built for the developer and AI community by AstroChalit.

Available Tools

83 tools
get_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

    C2.1/5.0

    Scored across 83 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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).

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables AI assistants to access Indian Vedic astrology services including Panchang, Kundli, matchmaking, and festivals through natural language.
      128
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      Provides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      5
      1
      AGPL 3.0