AstroChalit MCP Server

This is a Model Context Protocol (MCP) server that provides AI assistants (like Claude Desktop and Cursor) native access to the AstroChalit API.

By installing this MCP server, your AI assistant can automatically pull real-time Vedic astrology data, including daily horoscopes for any zodiac sign.

Prerequisites

• Node.js (v18 or higher)
• An active AstroChalit API Key

Installation & Configuration

For 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 the astrochalit server to your mcpServers object. Replace YOUR_API_KEY_HERE with your actual AstroChalit API key:

{
  "mcpServers": {
    "astrochalit": {
      "command": "npx",
      "args": ["-y", "astrochalit-mcp-server"],
      "env": {
        "ASTROCHALIT_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

3. Restart Claude Desktop.

Usage

Once configured, simply ask Claude to use the tool. For example:

• "What is the daily horoscope for Aries?"
• "Can you get the horoscope for Leo and summarize the career advice?"

Claude will automatically execute the get_horoscope tool, fetch the real-time data from the AstroChalit backend, and provide you with a personalized response.

Development

If you want to run this server locally from the source code:

1. Clone the repository
2. Run npm install
3. Run npm run build
4. Test the execution:

   ASTROCHALIT_API_KEY=test_key node build/index.js
   

Available Tools

This MCP server dynamically registers our suite of astrology tools by directly mirroring the AstroChalit backend endpoints.

Key tool categories include:

• Horoscope: get_horoscope
• Panchang & Muhurta: get_panchang, get_chaugadiya_muhurta, get_hora_muhurta
• Matchmaking (Ashtakoot & Dashakoot): get_ashtakoot, get_dashakoot, get_match_birthchart
• Divisional Charts: get_divisional_chart_d1 through get_divisional_chart_d60
• Varshphal (Annual): get_varshphal_details, get_varshphal_year_chart, get_varshphal_month_chart, etc.
• Doshas: get_manglik_report, get_sadesati_dosha, get_kaalsarp_dosha, get_pitru_dosha
• Numerology: get_numerologyreport, get_numerologynumbers, get_lifepath_prediction
• KP Astrology: get_kp_planets, get_kp_house_cups, get_kp_significators
• Planetary Calculations: get_planetary_position, get_planet_aspects, get_moon_phases
• Remedies: get_rudraksha_suggestion, get_gemstone_suggestion

Most tools require a standard set of parameters including day, month, year, hour, minute, second, latitude, and longitude. Matchmaking tools require these details for both male (m_day, etc.) and female (f_day, etc.).