🪔 Kundali Chart MCP

The most comprehensive Vedic Astrology MCP server — 54 tools, zero setup.

AI-powered Kundali (birth chart) generation, analysis, and prediction — for Claude, Cursor, VS Code, Windsurf, Zed, and any MCP-compatible client.

🚀 Quick Start

npx kundali-chart-mcp

That's it. The server connects to a hosted backend — no Python, no dependencies, no configuration.

For Claude Code (CLI)

If you are using Anthropic's Claude Code terminal agent, you can register this server automatically in one command:

claude mcp add kundali-chart-mcp -- npx -y kundali-chart-mcp

Auto-setup for IDEs (Universal)

You can automatically register this server in any of your installed desktop coding agents (Cursor, VS Code, Claude Desktop, Windsurf, Zed, etc.) using the universal add-mcp tool:

npx add-mcp kundali-chart-mcp

Restart your IDE after running this command.

Manual IDE Config

If you prefer to configure it manually, add this to your client's MCP configuration settings:

💬 Try This

"Generate a kundali chart for someone born on 15 August 1990 at 6:30 AM in Mumbai, India"

"What doshas are present in my chart? Born 6 Nov 2002, 12:05 PM, Bareilly"

"Show me my Vimshottari Dasha periods"

"Check compatibility between these two charts..."

"What remedies should I follow for my debilitated Sun?"

"Is 2 PM today an auspicious time to start a new project?"

"What does my medical astrology say about health vulnerabilities?"

✨ Features

• 54 astrology tools — Charts, doshas, yogas, dasha, transits, compatibility, muhurta, remedies, medical astrology, and more
• Zero setup — No Python, no files, no configuration needed
• AI-ready — Works with Claude, Cursor, ChatGPT, Gemini, Copilot, any MCP client
• Professional grade — Swiss Ephemeris engine, BPHS-standard calculations
• Always up-to-date — Hosted backend means you always get the latest calculations

🔧 Manual Config

If auto-setup doesn't work for your IDE, add this to your MCP configuration:

{
  "mcpServers": {
    "kundali-chart": {
      "command": "npx",
      "args": ["kundali-chart-mcp"]
    }
  }
}

🪔 All 54 Tools

Core Chart

• generate_kundali — Full Vedic birth chart (9 planets, 12 houses, nakshatras)
• list_available_chart_types — D1–D60 vargas
• list_ayanamsa_modes — 30+ sidereal modes
• list_house_systems — Placidus, Koch, Equal, Whole Sign, etc.
• get_transit_positions — Current planetary transits
• search_birth_places — City geocoding
• get_timezone_for_coordinates — Timezone from lat/lon

Extended Analysis

• get_extended_chart — KP SubLord data
• get_vimshottari_dasha — Vimshottari Dasha (mahadasha + antardasha)
• get_pratyantar_dasha — 3-level dasha (MD → AD → PD)
• get_sookshma_dasha — 4th level dasha
• get_prana_dasha — 5th level dasha
• get_yogini_dasha — 8-yogini, 36-year cycle
• get_kalachakra_dasha — 112-year sign-based dasha
• get_char_dasha — Jaimini Chara Dasha
• get_narayana_dasha — Jaimini Narayana Dasha
• get_ashtottari_dasha — 108-year, 8-planet cycle
• get_planetary_aspects — All planetary aspects
• get_significators — KP planet-wise and house-wise significators

Yogas & Doshas

• get_yogas — Raj Yoga, Gaja Kesari, Dhana Yoga, and 50+ more
• get_doshas — Mangal Dosha, Kaal Sarp Dosha, Sade Sati, Graha Yuddha, Combustion
• get_special_conditions — Vargottama, Pushkara Navamsha, Dig Bala, Jaimini Karakas
• get_nabhasha_yogas — Ashrayas, Dala, Akriti yogas
• get_arishta — Longevity assessment yogas
• get_kartari — Kartari Yoga (hemmed between benefics/malefics)
• get_gandanta — Gandanta zone analysis

Panchanga & Muhurta

• get_panchanga — Tithi, Vara, Nakshatra, Yoga, Karana
• get_muhurta — Auspicious timing score for any datetime
• get_best_muhurta — Top 5 auspicious windows in a date range
• get_hora — Planetary Hour
• get_inauspicious_times — Rahu Kala, Yamaganda, Gulika, Choghadiya, Abhijit Muhurta, Brahma Muhurta
• check_time_auspiciousness — Is a specific time auspicious or inauspicious?

Transits & Returns

• get_gochara — Vedic transit analysis
• get_varshaphal — Solar Return chart
• get_tajaka — Tajaka annual analysis
• get_lunar_return — Chandraphal (Lunar Return)
• get_bhava_chalit — Actual house positions

Compatibility & Special

• get_compatibility — Ashtakoot Milan (36-point marriage compatibility)
• get_jaimini — Full Jaimini analysis: Chara Karakas, aspects, Karakamsha
• get_shadbala — Six-fold planetary strength
• get_ashtavarga — Benefic point scores
• get_avasthas — 9 planetary states + Baladi Avasthas
• get_upagrahas — Shadow sub-planets: Gulika, Mandi, Dhuma
• get_nakshatra_analysis — Deep nakshatra information per planet
• get_sudarshana_chakra — Triple-layer chart analysis
• get_prasna — Horary/Question chart
• get_kurmachakra — Directional analysis
• get_travel_direction_score — Direction auspiciousness score (0-100)
• get_full_kurmachakra_chart — All 9 directions reference

Arudha & Image

• get_arudha_lagna — Arudha Lagna (AL) + all 12 Arudha Padas — how the world perceives you
• get_upapada — Upapada Lagna — marriage nature and spouse characteristics

Remedies & Health

• get_remedial_measures — Personalized gemstones, mantras, charity, fasting, lifestyle remedies
• get_medical_astrology — Health predictions, Ayurvedic Dosha balance, vulnerable body parts

📝 License

MIT