Prokerala Astrology MCP

What is Prokerala Astrology MCP?

An MCP server that integrates the Prokerala API to provide Vedic astrology services such as horoscopes, panchang details, and compatibility analysis. It offers both command-line and web interfaces for developers and astrology enthusiasts.

How to use Prokerala Astrology MCP?

Clone the repository, set up a Python 3.12+ virtual environment, install dependencies, and create a .env file with your Prokerala API credentials and OpenAI API key. Start the server with fastmcp run coremcp.py:mcp --transport sse, then run the test client (python testclient.py) or the Chainlit web UI (chainlit run ui.py).

Key features of Prokerala Astrology MCP

• Vedic astrology consultations and daily horoscope readings
• Panchang details (tithi, nakshatra, yoga)
• Kundli matching and compatibility analysis
• Manglik Dosha analysis
• Multiple interfaces: CLI and Web UI (Chainlit)
• Support for multiple Indian languages

Use cases of Prokerala Astrology MCP

• Get personalized daily horoscopes for any zodiac sign
• Perform compatibility checks (porutham) for prospective couples
• Analyze birth chart planetary positions and doshas
• Retrieve daily panchang details for ritual scheduling
• Build an AI-powered astrology assistant using the MCP tools

FAQ from Prokerala Astrology MCP

What dependencies are required?

Python 3.12 or higher, pip, and a virtual environment. Dependencies are listed in requirements.txt.

How do I set up API credentials?

Create a .env file with OPENAI_API_KEY, CLIENT_ID, CLIENT_SECRET, and TOKEN_FILE_PATH (path to store the access token).

What transport does the server use?

The server runs with SSE transport on http://localhost:8000. Clients connect via MCPServerSse.

What if I get authentication errors?

Verify your API credentials in the .env file and ensure the token file has proper permissions.

How should I format dates for API calls?

Use the format YYYY-MM-DD HH:MM AM/PM. The system automatically converts for API calls.