🙏 Divine API — Indian Astrology MCP Server

🙏 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:

🚀 Quick Start

1. Get Your API Credentials

Sign up at divineapi.com and get your:

• 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 (128 Total)

🗓️ Panchang (Daily Vedic Calendar) — 6 Tools

🗓️ Panchang Extended — 7 Tools

⏰ Timings (Muhurat & Gowri Panchangam) — 3 Tools

🕉️ Muhurat Finder - 9 Tools

🔮 Kundli (Birth Chart) Basics — 9 Tools

⚠️ Doshas — 4 Tools

🪐 Dasha Systems — 6 Tools

💪 Yogas & Strengths — 8 Tools

📊 Ashtakvarga — 3 Tools

🌑 Sub Planets (Upagrahas) — 2 Tools

📜 Jaimini Astrology — 4 Tools

🎯 KP (Krishnamurti Paddhati) — 5 Tools

🚀 Transits — 6 Tools

💑 Matchmaking (Kundli Milan) — 7 Tools

🎉 Festivals — 7 Tools

📕 Lal Kitab — 16 Tools

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

🎂 Varshphal (Annual Chart) - 14 Tools

📅 Monthly Lists — 5 Tools

🌐 Language Support

All tools support multiple Indian languages via the lan parameter:

🛠️ 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

• 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: [email protected]