astrochalit-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,30 +1,41 @@
 # 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**.
+[![npm version](https://img.shields.io/npm/v/astrochalit-mcp.svg)](https://www.npmjs.com/package/astrochalit-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/astrochalit-mcp.svg)](https://www.npmjs.com/package/astrochalit-mcp)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
 
-By installing this MCP server, your AI assistant can automatically pull real-time Vedic astrology data, including daily horoscopes for any zodiac sign.
+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](https://www.npmjs.com/package/astrochalit-mcp)
+- **API Documentation & Keys**: [https://www.vedicastrologyapi.com](https://www.vedicastrologyapi.com)
+
+---
 
 ## Prerequisites
 
-- Node.js (v18 or higher)
-- An active AstroChalit API Key
+- **Node.js**: v18.0.0 or higher
+- **AstroChalit / VedicAstrologyAPI Key**: Get an API key from [vedicastrologyapi.com](https://www.vedicastrologyapi.com)
+
+---
 
 ## Installation & Configuration
 
-### For Claude Desktop
+### 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`
+   - **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:
+2. Add `astrochalit` to your `mcpServers` configuration:
 
 ```json
 {
   "mcpServers": {
     "astrochalit": {
       "command": "npx",
-      "args": ["-y", "astrochalit-mcp-server"],
+      "args": ["-y", "astrochalit-mcp"],
       "env": {
         "ASTROCHALIT_API_KEY": "YOUR_API_KEY_HERE"
       }
@@ -35,40 +46,114 @@ By installing this MCP server, your AI assistant can automatically pull real-tim
 
 3. Restart Claude Desktop.
 
-## Usage
+---
+
+### 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."*
+- *"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)
 
-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?"*
+This MCP server provides comprehensive access across the full Vedic astrology system:
 
-Claude will automatically execute the `get_horoscope` tool, fetch the real-time data from the AstroChalit backend, and provide you with a personalized response.
+### 1. Horoscopes & Daily Predictions
+- `get_horoscope` - Daily, weekly, monthly, and yearly horoscopes for all 12 signs.
 
-## Development
+### 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.
 
-If you want to run this server locally from the source code:
+### 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)
 
-1. Clone the repository
-2. Run `npm install`
-3. Run `npm run build`
-4. Test the execution: 
-   ```bash
-   ASTROCHALIT_API_KEY=test_key node build/index.js
-   ```
+### 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.
 
-## Available Tools
+### 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:
+
+```bash
+# 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
+```
 
-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`
+## License
 
-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.).
+ISC License. Built for the developer and AI community by [AstroChalit](https://www.vedicastrologyapi.com).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrochalit-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "main": "build/index.js",
   "bin": {
     "astrochalit-mcp": "build/index.js"
@@ -23,6 +23,7 @@
   "author": "",
   "license": "ISC",
   "description": "Model Context Protocol (MCP) server for AstroChalit / Vedic Astrology API",
+  "homepage": "https://www.npmjs.com/package/astrochalit-mcp",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.6.0",
     "axios": "^1.8.1",