AzanCAUTION
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.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Azan-MCP is an open-source Model Context Protocol (MCP) server that brings a comprehensive suite of Islamic utilities directly into AI assistants such as Claude Desktop. It enables any LLM client that supports MCP to answer Islamic questions with accuracy, proper sourcing, and full awareness of the user's location, timezone, and madhab.
What it does
- Prayer Times — Calculates the five daily prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) plus Sunrise for any location on Earth using the full Meeus solar algorithm. Supports 10 internationally recognised calculation methods and both Hanafi and Shafi madhab for Asr. Also computes Qibla direction, monthly calendars, and Sunnah prayer windows (Duha, Awwabin, Tahajjud).
- Azan & Iqama — Returns the full Azan text in Arabic and transliteration (with the Fajr Tatwidh variant), calculates Iqama times based on configurable per-prayer offsets, and provides a complete daily Azan schedule.
- Islamic Calendar — Converts dates between Gregorian and Hijri calendars, lists named Islamic events with their Gregorian equivalents, and identifies recommended voluntary fasting days (Mondays/Thursdays, Ayyam al-Beed, 6 days of Shawwal, Day of Arafah).
- Du'a & Dhikr — Provides sourced morning and evening adhkar, du'a collections across 15 topics (travel, eating, anxiety, protection, and more), and du'as for every
fa8855b07f63OBSERVED · 2026-10-02Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add azan-mcp -- uvx azan-mcp
{
"mcpServers": {
"azan-mcp": {
"command": "uvx",
"args": [
"azan-mcp"
]
}
}
}Exposed tools (34)
28 read · 6 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
calculate_fasting_times | write | Return Suhoor end (Fajr) and Iftar start (Maghrib) for each day in a date range (max 31 days). Dates in ISO 8601 format. |
calculate_gold_nisab | read | Return the Zakat Nisab threshold based on 85 grams of gold at the given price. |
calculate_inheritance_basic | read | Calculate basic Faraid (Islamic inheritance) fixed shares. spouse: |
calculate_silver_nisab | read | Return the Zakat Nisab threshold based on 595 grams of silver at the given price. |
calculate_zakat | read | Calculate Zakat due on wealth. wealth_type: cash, gold, silver, trade_goods. Provide gold or silver price per gram to determine nisab. |
convert_gregorian_to_hijri | read | Convert a Gregorian calendar date to its Hijri equivalent. |
convert_hijri_to_gregorian | read | Convert a Hijri calendar date to its Gregorian equivalent. |
get_asma_ul_husna | read | Return all 99 Names of Allah (Asma ul-Husna) with Arabic, transliteration, meaning, and explanation. |
get_azan_text | read | Return the full Azan text. prayer: fajr, dhuhr, asr, maghrib, isha. language: arabic, transliteration, or both. |
get_counter_recommendation | read | Return the recommended repetition count and virtues for a specific dhikr by its ID. |
get_daily_azan_schedule | write | Return today |
get_dua_by_topic | read | Return all du |
get_eid_dates | read | Return the Gregorian dates of Eid al-Fitr and Eid al-Adha for a given year. |
get_evening_adhkar | write | Return the complete set of evening adhkar (Adhkar al-Masa) with Arabic, transliteration, translation, source, and recommended count. |
get_hijri_date | read | Return today |
get_iqama_time | read | Return the Iqama time (adhan + configured offset) for a given prayer. prayer: fajr, dhuhr, asr, maghrib, isha. |
get_islamic_events | read | Return named Islamic events for a Hijri year. Optionally filter by hijri_month (1–12). |
get_monthly_prayer_calendar | read | Return a full month |
get_morning_adhkar | write | Return the complete set of morning adhkar (Adhkar al-Sabah) with Arabic, transliteration, translation, source, and recommended count. |
get_name_of_allah | read | Look up a specific Name of Allah by number (1–99) or transliteration (e.g. |
get_next_prayer | read | Return the name and time of the next upcoming prayer from right now. |
get_prayer_dua | read | Return du |
get_prayer_times | read | Return all 5 daily prayer times plus Sunrise for a given date and location. Date is ISO 8601 (YYYY-MM-DD); defaults to today. Location defaults to configured coordinates. |
get_qibla_direction | read | Return the Qibla bearing in degrees and 16-point cardinal direction toward the Kaaba in Makkah. |
get_ramadan_dates | write | Return the Gregorian start and end dates of Ramadan for a given year. |
get_server_info | read | Return the currently active server configuration: location, timezone, calculation method, madhab, and iqama offsets. |
get_sunnah_prayer_times | read | Return Duha (Ishraq) and Tahajjud time windows for a given date. |
get_time_until_next_prayer | read | Return minutes until the next prayer and a human-readable countdown string (e.g. |
get_voluntary_fasting_dates | read | Return all recommended voluntary fasting days in a given Gregorian month: Mondays/Thursdays, Ayyam al-Beed, Day of Arafah, 6 days of Shawwal. |
list_calculation_methods | read | List all 10 supported prayer time calculation methods with their Fajr/Isha angles. |
list_dua_topics | read | List all available du |
search_asma_ul_husna | read | Search the 99 Names of Allah by meaning, transliteration, or Arabic text. |
search_dua | read | Search across all du |
set_iqama_offset | write | Update the Iqama offset (minutes after adhan) for a prayer. Change is in-memory only and resets on server restart. |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (5)
__init__.cpython-314.pyc
config.cpython-314.pyc
prayer_engine.cpython-314.pyc
server.cpython-314.pyc
__init__.cpython-314.pyc
Gates applied: no_behavioural_pass.
fa8855b07f63full audit observations/trust-audit/mcp-server/ahmedeltaher__azan.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-02 | fa8855b07f63 | CAUTION | B | 89 | first audit |
Questions
What is the Azan MCP server?
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.
What tools does Azan expose?
34 in total: 28 read-only, 6 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Azan safe to connect to an agent?
With care. The audit graded it B (89/100) and found 5 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does Azan need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (fa8855b07f63), read on 2026-10-02. The repository is watched and re-audited when it changes.