Aladhan MCP Server: Powering AI Agents with Islamic Data

In the rapidly evolving landscape of AI, the ability of AI agents to access and interpret real-world data is paramount. The Aladhan MCP Server emerges as a crucial tool, providing AI agents with accurate Islamic prayer times, Qibla direction, and Hijri date conversions. This server leverages the Aladhan API, ensuring that AI applications can seamlessly integrate religious context into their functionalities.

What is an MCP Server?

Before delving into the specifics of the Aladhan MCP Server, it’s essential to understand the underlying technology. MCP, or Model Context Protocol, is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). In essence, an MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools. This is particularly useful for AI agents that need to perform tasks based on real-time or specific data.

Key Features of Aladhan MCP Server

The Aladhan MCP Server offers a comprehensive suite of features tailored to Islamic practices and observances:

• Accurate Prayer Times: Access precise Islamic prayer times for any location, be it a city or specific GPS coordinates.
• Date Conversion: Convert dates between the Gregorian and Hijri calendars, catering to the needs of Islamic applications.
• Qibla Direction: Determine the Qibla direction (the direction of Mecca) from any location, essential for prayer.
• Flexible Calculation Methods: Support for various prayer time calculation methods, ensuring accuracy across different regions and interpretations.
• Global Coverage: Utilizes the Aladhan API to provide worldwide coverage, making it a versatile tool for global applications.
• Multiple Input Formats: Accepts both city names and GPS coordinates, enhancing flexibility for developers.

Use Cases

The Aladhan MCP Server opens up a plethora of possibilities for AI agent development. Here are some notable use cases:

• Smart Mosques: Integrate prayer time notifications and Qibla direction into smart mosque systems.
• Islamic Calendar Applications: Develop AI-powered calendar applications that seamlessly convert dates and provide relevant Islamic information.
• Travel Applications: Enhance travel applications with accurate prayer times and Qibla direction for Muslim travelers.
• Personal Assistant AI: Enable personal AI assistants to provide prayer time reminders and Islamic date information.
• Educational Tools: Create interactive educational tools that teach users about Islamic practices and traditions.

Installation and Configuration

Setting up the Aladhan MCP Server is straightforward:

1. Prerequisites: Ensure you have Python 3.8 or higher installed.
2. Install Dependencies: Use pip install -r requirements.txt or pip install mcp requests to install the necessary packages.
3. Configuration: For Claude Desktop, add the server configuration to the claude_desktop_config.json file, specifying the path to the aladhan_mcp_server.py file.
4. Direct Execution: Alternatively, run the server directly using python aladhan_mcp_server.py.

Available Tools

The server provides several tools accessible through MCP calls:

1. Get Prayer Times by City: Retrieve prayer times for a specific city and date.
2. Get Prayer Times by Coordinates: Obtain prayer times based on latitude and longitude.
3. Convert Gregorian to Hijri Date: Convert a Gregorian date to its Hijri equivalent.
4. Get Qibla Direction: Determine the Qibla direction for a given location.
5. Get Calculation Methods: List available prayer time calculation methods.

Supported Calculation Methods

The Aladhan MCP Server supports a wide range of calculation methods, including:

• University of Islamic Sciences, Karachi
• Islamic Society of North America (ISNA)
• Muslim World League (MWL)
• Umm al-Qura University, Makkah
• Egyptian General Authority of Survey
• And many more…

API Reference and Troubleshooting

The server relies on the Aladhan API for accurate data. Troubleshooting tips are provided for common issues such as server startup failures, API call errors, and missing dependencies.

Contributing and License

The project is open-source and welcomes contributions. It is licensed under the MIT License, encouraging collaboration and innovation.

Integrating Aladhan MCP Server with UBOS

UBOS (Ubiquitous Business Operating System) is a full-stack AI agent development platform that empowers businesses to integrate AI agents across various departments. By integrating the Aladhan MCP Server with UBOS, developers can create sophisticated AI agents capable of understanding and responding to Islamic contexts.

Here’s how the integration can be beneficial:

• Enhanced AI Agent Capabilities: UBOS enables AI agents to access real-time Islamic data, enhancing their ability to provide contextually relevant information.
• Custom AI Agent Development: UBOS facilitates the creation of custom AI agents tailored to specific needs, such as prayer time reminders, Islamic calendar management, and Qibla direction assistance.
• Multi-Agent Systems: UBOS supports the orchestration of multi-agent systems, allowing developers to create complex AI solutions that leverage the Aladhan MCP Server.
• Seamless Data Integration: UBOS simplifies the process of connecting AI agents with enterprise data, ensuring that the agents have access to the information they need to perform their tasks effectively.

Example Integration Scenario:

Imagine a customer support AI agent built on UBOS for an Islamic travel agency. By integrating the Aladhan MCP Server, the AI agent can:

• Provide accurate prayer times for the traveler’s destination.
• Offer Qibla direction assistance.
• Convert travel dates to the Hijri calendar.
• Answer questions related to Islamic observances during travel.

This integration enhances the AI agent’s ability to provide personalized and relevant support, improving the customer experience.

Conclusion

The Aladhan MCP Server is a valuable resource for developers looking to integrate Islamic context into AI applications. By providing accurate prayer times, date conversions, and Qibla direction, it enables the creation of intelligent and culturally sensitive AI agents. When combined with the UBOS platform, the possibilities are endless, opening new avenues for innovation in the AI space.