azan
Azan + Prayer Time + MCP + AI Agents + Islamic + Salah + A lightweight MCP library to calculate prayer times and trigger Azan with a single tool call. If you’re building an AI agent or prayer application, there’s no need to deal with astronomical calculations, timezones, or edge cases again.
claude mcp add --transport stdio ahmedeltaher-azan-mcp gradle assembleRelease
How to use
AZAN is an Android/Kotlin library for calculating Islamic prayer times. It provides a simple interface to compute prayer times based on location, timezone, latitude, longitude, and calculation method. The README shows how to integrate the library via Gradle (through JitPack) and demonstrates usage by creating a location object, selecting a calculation method, and retrieving prayer times such as fajr, sunrise, dhuhr, asr, maghrib, and isha. The library is designed to let you query prayer times for a given date with a single call and supports multiple calculation methods including MWL, Umm al-Qura, Islamic Society ISNA, and more.
To use it, add the JitPack repository to your root Gradle build, then add the dependency in your app module. After that, you can instantiate an Azan object with a Location and Method, call getPrayerTimes for a given date, and access individual times like fajr() or ishaa(). The README also includes a short example that prints the computed times for a given day.
How to install
Prerequisites:
- Java Development Kit (JDK) and Android Studio installed
- Gradle-enabled Android project
Installation steps:
- Add JitPack repository to your root build.gradle at the end of repositories:
allprojects { repositories { maven { url 'https://jitpack.io' } } }
- Add the Azan dependency to your app module's build.gradle:
dependencies { implementation 'com.github.ahmedeltaher:Azan:3.0' }
- Sync your project with Gradle files. You can then import and use the Azan API in your code as shown in the README example.
Additional notes
Notes and tips:
- The library relies on various prayer time calculation methods. Choose the one that matches your region requirements (e.g., MWL, Umm al-Qura, Egyptian, ISNA).
- Ensure you provide accurate latitude, longitude, and timezone to get correct results.
- The README references Gradle usage and a sample Kotlin snippet; adapt the example to fit your app architecture.
- This repository appears to be a library rather than a standalone server, so MCP-style server setup is not required for usage.
Related MCP Servers
llm-functions
Easily create LLM tools and agents using plain Bash/JavaScript/Python functions.
model-context-protocol-resources
Exploring the Model Context Protocol (MCP) through practical guides, clients, and servers I've built while learning about this new protocol.
open-skills
Battle-tested skill library for AI agents. Save 98% of API costs with ready-to-use code for crypto, PDFs, search, web scraping & more. No trial-and-error, no expensive APIs.
mcp-batchit
🚀 MCP aggregator for batching multiple tool calls into a single request. Reduces overhead, saves tokens, and simplifies complex operations in AI agent workflows.
mcp-ai-agent
AI Agent built with Google ADK that leverages Google Maps MCP Server to answer real-world location questions with tool usage and traceable execution via Opik.
mcp-json-yaml-toml
A structured data reader and writer like 'jq' and 'yq' for AI Agents