Skip to main content
Glama
nitishautomates

mcp-indian-astrology

๐Ÿ™ 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

Sign up at divineapi.com and get your:

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 (128 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

๐Ÿ•‰๏ธ Muhurat Finder - 9 Tools

Tool

Description

divine_get_muhurat_marriage

Get the Marriage Muhurat (auspicious wedding dates) for a given month and location

divine_get_muhurat_house_entering

Get the Griha Pravesh (house-entering) Muhurat for a given month and location

divine_get_muhurat_vehicle_purchase

Get the Vehicle Purchase Muhurat for a given month and location

divine_get_muhurat_property_purchase

Get the Property Purchase Muhurat for a given month and location

divine_get_muhurat_business_start

Get the Business Start Muhurat for a given month and location

divine_get_muhurat_foundation_laying

Get the Foundation Laying (Bhoomi Pujan) Muhurat for a given month and location

divine_get_muhurat_do_ghati

Get the Do Ghati Muhurat for a given date and location

divine_get_muhurat_hora

Get the Hora (planetary hour) timings for a given date and location

divine_get_muhurat_jain_pachakkhan

Get the Jain Pachakkhan timings 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 planet (mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto)

๐Ÿ’‘ 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) โ€” 7 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

divine_get_rudraksha_suggestion

Get Rudraksha (mukhi bead) suggestions (life, lucky, and dasha beads) from birth data

๐ŸŽ‚ Varshphal (Annual Chart) - 14 Tools

Tool

Description

divine_get_varshphal_varsha_pravesh

Get the annual solar-return (Varsha Pravesh) moment for the given year

divine_get_varshphal_basic_astro_details

Get basic annual-chart astro details for the given year

divine_get_varshphal_planetary_positions

Get annual-chart planetary positions for the given year

divine_get_varshphal_horoscope_chart

Get the annual divisional chart (D1..D60) as SVG for the given year

divine_get_varshphal_tajika_aspect

Get Tajika aspects (ithasala, etc.) for the annual chart

divine_get_varshphal_muntha

Get the Muntha (progressed ascendant) for the given year

divine_get_varshphal_panchadhikari

Get the Panchadhikari (five year-lords) for the given year

divine_get_varshphal_tri_pataki_chakra

Get the Tri Pataki Chakra for the annual chart

divine_get_varshphal_mudda_dasha

Get the Mudda Dasha (annual dasha) for the given year

divine_get_varshphal_yogini_dasha

Get the annual Yogini Dasha for the given year

divine_get_varshphal_patyanini_dasha

Get the Patyanini Dasha for the given year

divine_get_varshphal_planetary_strengths

Get annual-chart planetary strengths (harsha bala, pancha vargiya bala)

divine_get_varshphal_sahams

Get the Sahams (sensitive points) for the annual chart

divine_get_varshphal_yogas

Get Tajika yogas for the annual chart

๐Ÿ“… 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

  1. Go to divineapi.com and sign up

  2. Start your 7-day free trial (no charges)

  3. Find your API Key at divineapi.com/api-keys

  4. Find your Auth Token on your profile page

  5. Set them as environment variables or in your MCP client config


๐Ÿ“– API Documentation


๐Ÿ“ 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

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

โ€“Maintainers
โ€“Response time
โ€“Release cycle
โ€“Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    World's first Vedic Astrology MCP Server โ€” connect Claude, ChatGPT, Cursor, or any AI to real Vedic astrology. Provides horoscope predictions, compatibility matching, numerology, planetary positions, yogas and house analysis via MCP.
    6
  • A
    license
    A
    quality
    C
    maintenance
    Provides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.
    3
    64
    MIT
  • A
    license
    -
    quality
    C
    maintenance
    Exposes Vedic astrology tools for birth chart, dasha, transit calculations, and question context analysis.
    MIT

View all related MCP servers

Related MCP Connectors

  • Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.

  • Free Vedic astrology: panchang, kundali, transits, matching, doshas, eclipses, numerology

  • Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.

View all MCP Connectors

Latest Blog Posts

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