Check Muslim Prayer Due Status
get_prayer_statusChecks if a Muslim obligatory prayer (Fajr, Dhuhr, Asr, Maghrib, Isha) is currently due for the user location and returns active reminder details. MANDATORY: The LLM must always explicitly disclose to the user which calculation authority method was used and why it was selected (see authorityNotice in response).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| madhab | No | Optional Asr shadow jurisprudence override (Shafi or Hanafi) | |
| userId | No | Unique user or device ID for preference and deduplication tracking | |
| latitude | No | Optional explicit latitude override | |
| timezone | No | Optional IANA timezone override (e.g. Asia/Riyadh) | |
| longitude | No | Optional explicit longitude override | |
| calculationMethod | No | Optional calculation authority override (auto-resolved from location by default) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| madhab | Yes | Active Asr jurisprudence | |
| prayer | No | The name of the currently due prayer if applicable | |
| timezone | Yes | Resolved IANA timezone | |
| dedupeKey | No | Deduplication cache key | |
| localDate | Yes | Current local date in YYYY-MM-DD | |
| nextPrayer | Yes | The name of the next upcoming prayer | |
| reminderDue | Yes | Whether a prayer is currently due for reminder | |
| expiresAtUtc | No | UTC expiration time of the active prayer window | |
| reminderText | No | Localized reminder message | |
| startedAtUtc | No | UTC start time of the active prayer window | |
| locationSource | Yes | Source of location resolution | |
| authorityNotice | No | Mandatory theological transparency notice | |
| nextPrayerAtUtc | Yes | UTC timestamp of the next upcoming prayer | |
| selectionReason | No | Reason for authority selection | |
| calculationMethod | Yes | Active calculation authority | |
| minuteAdjustments | No | Applied minute adjustments | |
| authorityDescription | No | Description of the calculation authority |