How do I use mcp-indian-astrology?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-indian-astrology What's today's Panchang for Delhi?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-indian-astrology

by nitishautomates

Overview Schema Related Servers Score Discussions

Python

Remote

🙏 Divine API — Indian Astrology MCP Server

The official Model Context Protocol (MCP) server for Divine API's Indian/Vedic Astrology services.

Connect your AI assistant (Claude, Cursor, VS Code Copilot, etc.) to the power of Vedic astrology — Panchang, Kundli, Matchmaking, Festivals, and more — all through natural language.

✨ What Can It Do?

Just chat naturally with your AI assistant:

You say...	The MCP calls...
"What's today's Panchang for Delhi?"	`divine_get_panchang`
"Generate my Kundli — born March 15, 1990, 2:30 PM, Mumbai"	`divine_get_basic_astro_details`
"Am I Manglik?"	`divine_get_manglik_dosha`
"Match Kundli for Rahul and Simran"	`divine_get_ashtakoot_milan`
"What festivals are in Kartik month 2025?"	`divine_get_festivals_by_month`
"Show me the Navamsha (D9) chart"	`divine_get_horoscope_chart`
"What gemstone should I wear?"	`divine_get_gemstone_suggestions`
"Is Sadhe Sati active for me?"	`divine_get_sadhe_sati`

Related MCP server: VedIntel AstroAPI MCP

🚀 Quick Start

1. Get Your API Credentials

API Key — from divineapi.com/api-keys
Auth Token (Bearer Token) — from your profile page

You get a 7-day free trial — no charges until you decide to continue.

2. Install

pip install divineapi-indian-astrology-mcp

Or with uv (recommended):

uv pip install divineapi-indian-astrology-mcp

3. Configure Your AI Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "divine-indian-astrology": {
      "command": "python",
      "args": ["-m", "divineapi_indian_astrology_mcp"],
      "env": {
        "DIVINE_API_KEY": "your-api-key-here",
        "DIVINE_AUTH_TOKEN": "your-bearer-token-here"
      }
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "divine-indian-astrology": {
    "command": "python",
    "args": ["-m", "divineapi_indian_astrology_mcp"],
    "env": {
      "DIVINE_API_KEY": "your-api-key-here",
      "DIVINE_AUTH_TOKEN": "your-bearer-token-here"
    }
  }
}

Claude Code

claude mcp add divine-indian-astrology \
  -e DIVINE_API_KEY=your-api-key-here \
  -e DIVINE_AUTH_TOKEN=your-bearer-token-here \
  -- python -m divineapi_indian_astrology_mcp

4. Restart your AI client and start chatting!

📋 Available Tools (104 Total)

🗓️ Panchang (Daily Vedic Calendar) — 6 Tools

Tool	Description
`divine_get_panchang`	Get the complete daily Panchang for a given date and location
`divine_get_tithi`	Get tithi (lunar day) details for a given date and location
`divine_get_nakshatra`	Get nakshatra (lunar mansion) details for a given date and location
`divine_get_karana`	Get karana details for a given date and location
`divine_get_surya_nakshatra`	Get Surya (Sun) Nakshatra details for a given date and location
`divine_get_yoga_panchang`	Get yoga (Sun-Moon angular relationship) for a given date and location

🗓️ Panchang Extended — 7 Tools

Tool	Description
`divine_get_choghadiya`	Get Choghadiya (auspicious time slots) for a given date and location
`divine_get_nivas_and_shool`	Get Nivas and Shool (directional inauspicious timings) for a date and location
`divine_get_ritu_and_anaya`	Get Ritu (season) and Anaya details for a given date and location
`divine_get_samvat`	Get Samvat (Hindu calendar year) details for a given date and location
`divine_get_chandrabalam_and_tarabalam`	Get Chandrabalam and Tarabalam for a given date and location
`divine_get_other_calendars_and_epoch`	Get dates in other calendar systems and epoch values for a given date
`divine_get_sun_moon`	Get sun and moon rise/set timings for a given date and location

⏰ Timings (Muhurat & Gowri Panchangam) — 3 Tools

Tool	Description
`divine_get_auspicious_timings`	Get auspicious timings (shubh muhurat) for a given date and location
`divine_get_inauspicious_timings`	Get inauspicious timings for a given date and location
`divine_get_gowri_panchangam`	Get the Gowri Panchangam for a given date and location

🔮 Kundli (Birth Chart) Basics — 9 Tools

Tool	Description
`divine_get_basic_astro_details`	Get basic astrological details for a person based on their birth data
`divine_get_planetary_positions`	Get planetary positions in the birth chart (Kundli)
`divine_get_horoscope_chart`	Generate a Vedic horoscope chart (Kundli diagram) as SVG and image
`divine_get_bhava_kundli`	Get Bhava Kundli (house-based chart) for a given bhava chart number
`divine_get_planet_analysis`	Get detailed analysis of one planet in the birth chart
`divine_get_ascendant_report`	Get a detailed report based on the ascendant (Lagna) sign
`divine_get_uday_lagna`	Get Uday Lagna (rising sign) timings for a given date and location
`divine_get_chandramasa`	Get Chandramasa (Hindu lunar month) details for a given date and location
`divine_get_chandrashtama`	Get Chandrashtama periods for a given month and location

⚠️ Doshas — 4 Tools

Tool	Description
`divine_get_manglik_dosha`	Check for Manglik Dosha (Mangal Dosha / Kuja Dosha) in the birth chart
`divine_get_kaal_sarpa_yoga`	Check for Kaal Sarpa Yoga in the birth chart
`divine_get_pitra_dosha`	Check for Pitra Dosha (ancestral affliction) in the birth chart
`divine_get_sadhe_sati`	Check Sadhe Sati (Saturn transit) status for the person

🪐 Dasha Systems — 6 Tools

Tool	Description
`divine_get_vimshottari_dasha`	Get Vimshottari Dasha periods for a birth chart at the requested granularity
`divine_get_maha_dasha_analysis`	Get textual interpretation of a Maha Dasha period (no birth data needed)
`divine_get_antar_dasha_analysis`	Get textual interpretation of an Antar Dasha (Maha→Antar) period
`divine_get_pratyantar_dasha_analysis`	Get textual interpretation of a Pratyantar Dasha (Maha→Antar→Pratyantar) period
`divine_get_yogini_dasha`	Get Yogini Dasha periods for a birth chart
`divine_get_kaal_chakra_dasha`	Get Kaal Chakra Dasha periods for a birth chart

💪 Yogas & Strengths — 8 Tools

Tool	Description
`divine_get_yogas`	Get all yogas (planetary combinations) present in the birth chart
`divine_get_nav_pancham_yoga`	Get Nav Pancham Yoga compatibility analysis between two charts
`divine_get_shadbala`	Get Shadbala (six-fold planetary strength) for a birth chart
`divine_get_composite_friendship`	Get composite (Panchda) friendship table for all planets
`divine_get_ghata_chakra`	Get Ghata Chakra (adverse combinations) for a birth chart
`divine_get_sudarshana_chakra`	Get Sudarshana Chakra for a birth chart
`divine_get_panchak_rahita`	Check Panchak status for a given date and location
`divine_get_gemstone_suggestion`	Get gemstone recommendations based on the birth chart

📊 Ashtakvarga — 3 Tools

Tool	Description
`divine_get_ashtakvarga`	Get Bhinnashtakvarga (individual Ashtakvarga) tables for all planets
`divine_get_prasthara_chakra`	Get Prasthara Chakra (expanded Ashtakvarga) for a birth chart
`divine_get_sarvashtakavarga`	Get Sarvashtakavarga (combined Ashtakvarga) for a specific chart

🌑 Sub Planets (Upagrahas) — 2 Tools

Tool	Description
`divine_get_sub_planet_positions`	Get sub-planet (Upagraha) positions for a birth chart
`divine_get_sub_planet_chart`	Generate a sub-planet (Upagraha) chart as SVG and image

📜 Jaimini Astrology — 4 Tools

Tool	Description
`divine_get_jaimini_chara_dasha`	Get Jaimini Chara Dasha periods for a birth chart
`divine_get_jaimini_karakamsha_lagna`	Get Karakamsha Lagna from Jaimini astrology for a birth chart
`divine_get_jaimini_padas`	Get Jaimini Padas (Arudha Padas) for all houses in a birth chart
`divine_get_jaimini_planetary_positions`	Get Jaimini-specific planetary positions and karakas

🎯 KP (Krishnamurti Paddhati) — 5 Tools

Tool	Description
`divine_get_kp_cuspal_sub`	Get KP Cuspal Sub Lords for all house cusps
`divine_get_kp_planetary_sub`	Get KP Planetary Sub Lords for all planets
`divine_get_kp_cuspal_significator`	Get KP Planetary-Cuspal Significator Table
`divine_get_kp_cuspal`	Get KP Cuspal chart data for a birth chart
`divine_get_kp_planetary_positions`	Get KP Planetary Positions for a birth chart

🚀 Transits — 6 Tools

Tool	Description
`divine_get_kundli_transit_ascendant`	Get transit analysis from the Ascendant (Lagna) on a chosen transit date
`divine_get_kundli_transit_moon`	Get transit analysis from the Moon sign on a chosen transit date
`divine_get_grah_gochar`	Get Grah Gochar (planetary transit) data for a specific planet
`divine_get_planet_combustion_transit`	Get planet combustion (Asta) transit details for a specific planet
`divine_get_planet_nakshatra_transit`	Get nakshatra transit details for a specific planet
`divine_get_planet_retrograde_transit`	Get retrograde transit details for a specific planet

💑 Matchmaking (Kundli Milan) — 7 Tools

Tool	Description
`divine_get_ashtakoot_milan`	Perform Ashtakoot Milan (8-point compatibility matching) for two people
`divine_get_dashakoot_milan`	Perform Dashakoot Milan (10-point compatibility matching) for two people
`divine_get_matching_manglik`	Check Manglik Dosha for both people in a matchmaking context
`divine_get_matching_basic_astro`	Get basic astrological details for both persons in matchmaking
`divine_get_matching_horoscope_chart`
`divine_get_matching_vimshottari_dasha`	Get Vimshottari Dasha for both persons in matchmaking
`divine_get_matching_planetary_positions`	Get planetary positions for both persons in matchmaking

🎉 Festivals — 7 Tools

Tool	Description
`divine_get_festivals_by_date`	Get festivals falling on a specific date
`divine_get_english_calendar_festivals`	Get all Hindu festivals for a specific English calendar month
`divine_find_festival`	Find the date(s) of a specific festival in a given year
`divine_get_festivals_by_month`	Get all Hindu festivals for a specific Hindu calendar month
`divine_get_malayalam_festivals`	Get major Malayalam (Kerala) festivals for a year
`divine_get_tamil_festivals`	Get major Tamil festivals for a year
`divine_get_sankranti_festivals`	Get the twelve solar Sankranti festivals for a year

📕 Lal Kitab — 16 Tools

Tool	Description
`divine_get_lal_kitab_planetary_positions`	Get Lal Kitab planetary positions for a birth chart
`divine_get_lal_kitab_horoscope_chart`	Generate the Lal Kitab horoscope chart for a birth chart
`divine_get_lal_kitab_house_position`	Get Lal Kitab house positions for a birth chart
`divine_get_lal_kitab_conjunctions`	Get Lal Kitab planetary conjunctions for a birth chart
`divine_get_lal_kitab_teva`	Get Lal Kitab teva (chart conditions) for a birth chart
`divine_get_lal_kitab_planet_analysis`	Get Lal Kitab analysis of one planet in the birth chart
`divine_get_lal_kitab_dasha`	Get Lal Kitab dasha periods for a birth chart
`divine_get_lal_kitab_planet_types`	Get Lal Kitab planet types for a birth chart
`divine_get_lal_kitab_mahadasha_content`	Get textual Lal Kitab interpretation of a Mahadasha period
`divine_get_lal_kitab_antardasha_content`	Get textual Lal Kitab interpretation of a Mahadasha-Antardasha combination
`divine_get_lal_kitab_debts`	Get Lal Kitab debts (rin) for a birth chart
`divine_get_lal_kitab_house_signification`	Get the Lal Kitab signification of one house for a birth chart
`divine_get_lal_kitab_varsha_pravesh`	Get the Lal Kitab Varsha Pravesh (annual chart entry) for a chosen year
`divine_get_lal_kitab_varshphal_planetary_positions`	Get Lal Kitab varshphal (annual chart) planetary positions
`divine_get_lal_kitab_varshphal_muntha`	Get the Lal Kitab varshphal Muntha for a chosen year
`divine_get_lal_kitab_varshphal_chart`	Generate the Lal Kitab varshphal (annual) chart for a chosen year

🧭 Kundli Analysis (Vargottama, Bhava & Remedies) — 6 Tools

Tool	Description
`divine_get_vargottama_planets`	Get the vargottama planets (same sign in the D1 and D9 charts) for a birth chart
`divine_get_bhav_bala`	Get Bhava Bala (numeric strength of each of the twelve houses) for a birth chart
`divine_get_shani_ashtam_shani`	Get the Ashtama Shani analysis (Saturn in the 8th from natal Saturn) for a birth chart
`divine_get_bhava_analysis`	Get the house-by-house analysis (sign, lord, occupants, aspects) for a birth chart
`divine_get_bhava_group_predictions`	Get predictions grouped by house category (kendra, trikone, trishadaya, trik, maraka, dhana)
`divine_get_planet_remedies`	Get remedial measures (donation, gemstone, lifestyle, mantra) for one planet's placement

📅 Monthly Lists — 5 Tools

Tool	Description
`divine_get_chandramasa_list`	Get list of Chandramasa (Hindu lunar months) for a given period
`divine_get_month_nakshatra_list`	Get daily nakshatra list for a given month
`divine_get_month_sunrise_sunset_list`	Get daily sunrise and sunset times for a given month
`divine_get_month_surya_nakshatra_list`	Get daily Surya (Sun) Nakshatra list for a given month
`divine_get_month_tithi_list`	Get daily tithi list for a given month

🌐 Language Support

All tools support multiple Indian languages via the lan parameter:

Code	Language
`en`	English (default)
`hi`	Hindi
`ta`	Tamil
`te`	Telugu
`kn`	Kannada
`ml`	Malayalam
`bn`	Bengali
`gu`	Gujarati
`mr`	Marathi
`pa`	Punjabi
`or`	Odia
`ur`	Urdu

🛠️ Development / Running from Source

If you want to run from source instead of installing via pip:

# Clone the repository
git clone https://github.com/DivineAPI/mcp-indian-astrology.git
cd mcp-indian-astrology

# Install dependencies
pip install -r requirements.txt

# Set environment variables
export DIVINE_API_KEY="your-api-key"
export DIVINE_AUTH_TOKEN="your-bearer-token"

# Run the server
python server.py

Then configure your MCP client to point to the local file:

{
  "mcpServers": {
    "divine-indian-astrology": {
      "command": "python",
      "args": ["/full/path/to/mcp-indian-astrology/server.py"],
      "env": {
        "DIVINE_API_KEY": "your-api-key",
        "DIVINE_AUTH_TOKEN": "your-bearer-token"
      }
    }
  }
}

🔑 Getting Your API Credentials

Go to divineapi.com and sign up
Start your 7-day free trial (no charges)
Find your API Key at divineapi.com/api-keys
Find your Auth Token on your profile page
Set them as environment variables or in your MCP client config

📖 API Documentation

Full API Docs: developers.divineapi.com/indian-api
Support: support.divineapi.com
Pricing: divineapi.com/pricing

📝 License

MIT License — see LICENSE for details.

🏢 About Divine API

Divine API is a leading astrology technology company based in New Delhi, offering comprehensive Astrology, Kundali, Horoscope, Tarot, and Numerology APIs for businesses worldwide.

Contact: admin@divineapi.com

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nitishautomates/mcp-indian-astrology'

If you have feedback or need assistance with the MCP directory API, please join our Discord server