kundali-chart-mcp 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +104 -28
  3. package/package.json +1 -1
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 anirudh94100
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,32 +1,41 @@
1
- # Kundali MCP Server
1
+ # 🪔 Kundali Chart MCP
2
2
 
3
- MCP server for Vedic Kundali (birth) chart generation. Zero local dependencies calls a hosted Azure Function backend.
3
+ **The most comprehensive Vedic Astrology MCP server48 tools, zero dependencies.**
4
4
 
5
- ## Quick start
5
+ [![npm version](https://img.shields.io/npm/v/kundali-chart-mcp?color=orange)](https://www.npmjs.com/package/kundali-chart-mcp)
6
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
6
7
 
7
- ### 1. Install
8
+ *AI-powered Kundali (birth chart) generation, analysis, and prediction — for Claude, Cursor, VS Code, Windsurf, Zed, and any MCP-compatible client.*
8
9
 
9
- ```bash
10
- npm install -g kundali-chart-mcp
11
- ```
10
+ ---
12
11
 
13
- ### 2. Auto-configure your IDE
12
+ ## 🚀 Quick Start
14
13
 
15
14
  ```bash
15
+ npm install -g kundali-chart-mcp
16
16
  kundali-chart-mcp-setup
17
17
  ```
18
18
 
19
- This detects and configures: **Claude Desktop**, **Cursor**, **VS Code**, **Windsurf**, **Zed**.
19
+ Then restart your IDE. That's it.
20
20
 
21
- ### 3. Restart your IDE
21
+ ## 💬 Try This
22
22
 
23
- Done. Ask your AI assistant:
23
+ > *"Generate a kundali chart for someone born on 15 August 1990 at 6:30 AM in Mumbai, India"*
24
24
 
25
- > "Generate a kundali chart for someone born on 1990-01-01 at 12:00 in Delhi, India"
25
+ ---
26
26
 
27
- ## Manual config
27
+ ## Features
28
28
 
29
- If auto-setup doesn't work for your client:
29
+ - **48 astrology tools** Charts, doshas, yogas, dasha, transits, compatibility, muhurta
30
+ - **Zero local dependencies** — No Python, no ephemeris files
31
+ - **AI-ready** — Works with Claude, Cursor, ChatGPT, Gemini, Copilot, any MCP client
32
+ - **Free backend** — Hosted on Azure Functions
33
+ - **Self-hostable** — Deploy your own in 5 minutes
34
+ - **BPHS-grade** — Uses Swiss Ephemeris + vedicastro
35
+
36
+ ---
37
+
38
+ ## 🔧 Manual Config
30
39
 
31
40
  ```json
32
41
  {
@@ -38,30 +47,97 @@ If auto-setup doesn't work for your client:
38
47
  }
39
48
  ```
40
49
 
41
- ## Tools (48 total)
50
+ ---
51
+
52
+ ## 🪔 All 48 Tools
42
53
 
43
- - `generate_kundali` — Vedic birth chart
54
+ ### Core Chart
55
+ - `generate_kundali` — Full Vedic birth chart with all 9 planets, 12 houses, nakshatras
56
+ - `list_available_chart_types` — D1–D60 vargas
57
+ - `list_ayanamsa_modes` — 30+ sidereal modes
58
+ - `list_house_systems` — Placidus, Koch, Equal, Whole Sign, etc.
59
+ - `get_transit_positions` — Planetary transits
60
+ - `search_birth_places` — City geocoding
61
+ - `get_timezone_for_coordinates` — Timezone from lat/lon
62
+
63
+ ### Extended Analysis
44
64
  - `get_extended_chart` — KP SubLord data
45
- - `get_vimshottari_dasha` — Vimshottari Dasha periods
46
- - `get_panchanga` — 5 Vedic time limbs
47
- - `get_doshas` — Mangal, Kaal Sarp, Sade Sati, etc.
48
- - `get_yogas` — Vedic Yogas
65
+ - `get_vimshottari_dasha` — Vimshottari Dasha
66
+ - `get_pratyantar_dasha` — 3-level dasha
67
+ - `get_sookshma_dasha` — 4th level
68
+ - `get_prana_dasha` — 5th level
69
+ - `get_yogini_dasha` — 8-yogini cycle
70
+ - `get_kalachakra_dasha` — 112-year cycle
71
+ - `get_char_dasha` — Jaimini Chara Dasha
72
+ - `get_narayana_dasha` — Jaimini Narayana Dasha
73
+ - `get_ashtottari_dasha` — 108-year cycle
74
+ - `get_planetary_aspects` — All aspects
75
+ - `get_significators` — KP significators
76
+
77
+ ### Yogas & Doshas
78
+ - `get_yogas` — Raj Yoga, Gaja Kesari, Dhana, etc.
79
+ - `get_doshas` — Mangal, Kaal Sarp, Sade Sati
80
+ - `get_special_conditions` — Vargottama, Dig Bala
81
+ - `get_nabhasha_yogas` — Ashrayas, Dala, Akriti
82
+ - `get_arishta` — Longevity assessment
83
+ - `get_kartari` — Kartari Yoga
84
+ - `get_gandanta` — Gandanta zones
85
+
86
+ ### Panchanga & Muhurta
87
+ - `get_panchanga` — Tithi, Vara, Nakshatra, Yoga, Karana
88
+ - `get_muhurta` — Auspicious timing score
89
+ - `get_best_muhurta` — Top 5 windows
90
+ - `get_hora` — Planetary Hour
91
+
92
+ ### Transits & Returns
93
+ - `get_gochara` — Transit analysis
94
+ - `get_varshaphal` — Solar Return
95
+ - `get_tajaka` — Tajaka analysis
96
+ - `get_lunar_return` — Chandraphal
97
+ - `get_bhava_chalit` — House positions
98
+
99
+ ### Compatibility & Special
49
100
  - `get_compatibility` — Ashtakoot Milan (36-point)
101
+ - `get_jaimini` — Full Jaimini analysis
102
+ - `get_shadbala` — Six-fold strength
103
+ - `get_ashtakavarga` — Benefic points
104
+ - `get_avasthas` — 9 planetary states
105
+ - `get_upagrahas` — Shadow sub-planets
106
+ - `get_nakshatra_analysis` — Deep nakshatra info
107
+ - `get_sudarshana_chakra` — Triple-layer chart
108
+ - `get_prasna` — Horary chart
50
109
  - `get_kurmachakra` — Directional analysis
51
- - `get_muhurta` — Auspicious timing
52
- - `get_jaimini` — Jaimini astrology
53
- - ...and 38 more
110
+ - `get_travel_direction_score` — Direction score (0-100)
111
+ - `get_full_kurmachakra_chart` — All 9 directions
112
+
113
+ ---
54
114
 
55
- ## Deploy your own backend
115
+ ## 🏗 Self-Host
56
116
 
57
117
  ```bash
118
+ cd azure-function
58
119
  ./deploy.sh
59
120
  ```
60
121
 
61
- ## Local development (requires Python)
122
+ ---
123
+
124
+ ## 📡 API
62
125
 
63
126
  ```bash
64
- python3 -m venv .venv
65
- .venv/bin/pip install -r requirements.txt
66
- KUNDALI_MCP_PYTHON=.venv/bin/python node index.js
127
+ curl -X POST https://kundali-mcp-func.azurewebsites.net/api/kundali/generate_kundali \
128
+ -H "Content-Type: application/json" -d '{
129
+ "name": "Rahul",
130
+ "city": "Mumbai, India",
131
+ "date_of_birth": "1990-08-15",
132
+ "time_of_birth": "06:30",
133
+ "latitude": 19.076,
134
+ "longitude": 72.8777,
135
+ "timezone": "Asia/Kolkata"
136
+ }'
67
137
  ```
138
+
139
+ ---
140
+
141
+ ## 📝 License
142
+
143
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kundali-chart-mcp",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "MCP server for Vedic Kundali chart generation (Azure Function backend).",
5
5
  "type": "module",
6
6
  "bin": {