← Muslim Prayer ReminderCONTENT HISTORY

Update to Muslim Prayer Reminder

Snapshot Oct 24, 2026 · 13:17 UTC · version 1.0.2

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for muslim-prayer-mcp

Full description — Now says: Query prayer times and status using verified user location; explain calculation authority and applied approximations.

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Muslim Prayer Reminder and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Full description

Before

Oct 1, 2026 · 12:02 UTC

Teaches LLMs how to query Muslim prayer times, check current prayer due status, countdown to next prayer, and enforce mandatory calculation authority and selection justification disclosure.

After

Oct 24, 2026 · 13:17 UTC

Query prayer times and status using verified user location; explain calculation authority and applied approximations.

Skill instructions

Before

Oct 1, 2026 · 12:02 UTC

--- name: muslim-prayer-mcp description: Teaches LLMs how to query Muslim prayer times, check current prayer due status, countdown to next prayer, and enforce mandatory calculation authority and selection justification disclosure. --- #...

After

Oct 24, 2026 · 13:17 UTC

--- name: muslim-prayer-mcp description: Query prayer times and status using verified user location; explain calculation authority and applied approximations. --- # Muslim Prayer Reminder MCP Generated from src/mcp/schemas.ts by...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,132 +1,620 @@
----
-name: muslim-prayer-mcp
-description: Teaches LLMs how to query Muslim prayer times, check current prayer due status, countdown to next prayer, and enforce mandatory calculation authority and selection justification disclosure.
----
-
-# Muslim Prayer Reminder MCP
-
-This skill instructs LLMs (Claude, GPT, Cursor, Copilot, Gemini, Devin, etc.) on interacting with the Muslim Prayer Reminder MCP server (`muslim-prayer-mcp`), executing prayer-time tools, interpreting results, and formatting prayer outputs.
-
-## Server Endpoints
-- **Streamable HTTP (Remote Worker)**: `https://muslim-prayer-mcp.najetareqz.workers.dev/mcp`
-- **Local Stdio (NPX)**: `npx -y muslim-prayer-mcp`
-
----
-
-## ⚠️ MANDATORY DIRECTIVE: Authority and Selection Reason Disclosure
-
-Every time you present prayer times, next prayer countdowns, or prayer status to a user, you **MUST EXPLICITLY STATE**:
-1. **The calculation authority and method used** (e.g., Palestinian Ministry of Awqaf, Umm al-Qura University Makkah, Egyptian General Authority of Survey, Diyanet İşleri Başkanlığı, etc.).
-2. **Why that authority was selected** (e.g., automatically selected based on Gaza/Palestine coordinates with regional Awqaf safety offsets, matched user timezone Asia/Riyadh, user explicitly configured method, etc.).
-
-**Zero Exception Rule**: Never omit this disclosure. The `authorityNotice` object returned in all tool payloads contains the exact strings to use.
-
----
-
-## Tool Reference
-
-### 1. `get_prayer_status`
-Checks if an obligatory prayer (Fajr, Dhuhr, Asr, Maghrib, Isha) is currently due within the active reminder window.
-- **Parameters**:
-  - `userId` (string, optional): User ID for fetching stored preferences. Default: `'default_user'`.
-  - `lat` (number, optional): Latitude in decimal degrees (e.g., `31.50`).
-  - `lng` (number, optional): Longitude in decimal degrees (e.g., `34.46`).
-  - `timezone` (string, optional): IANA timezone identifier (e.g., `'Asia/Gaza'`).
-- **Response Shape**:
-  - `due` (boolean): `true` if a prayer is within its active reminder window.
-  - `prayer` (string | null): Name of the prayer due (`'Fajr'`, `'Dhuhr'`, `'Asr'`, `'Maghrib'`, `'Isha'`).
-  - `message` (string | null): Localized alert message (e.g., `"It is time for Maghrib prayer."`).
-  - `prayerTimeUtc` / `prayerTimeFormatted`: Timestamp of the prayer.
-  - `authorityNotice`: Mandatory authority details object.
-
-### 2. `get_today_prayer_times`
-Retrieves today's complete prayer schedule: Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha.
-- **Parameters**: `userId`, `lat`, `lng`, `timezone`.
-- **Response Shape**:
-  - `date`: Date string (`YYYY-MM-DD`).
-  - `timezone`: Active IANA timezone.
-  - `method`: Calculation method identifier.
-  - `madhab`: Madhab used for Asr calculation (`'shafi'` or `'hanafi'`).
-  - `times`: Map of prayers to `{ utc: ISOString, formatted: "HH:MM" }`.
-  - `authorityNotice`: Mandatory authority details object.
-
-### 3. `get_next_prayer`
-Identifies the upcoming prayer and remaining countdown time in minutes.
-- **Parameters**: `userId`, `lat`, `lng`, `timezone`.
-- **Response Shape**:
-  - `currentPrayer`: Currently ongoing prayer period.
-  - `nextPrayer`: Name of the next incoming prayer.
-  - `nextPrayerTimeFormatted`: Formatted local time.
-  - `minutesRemaining`: Minutes until prayer time.
-  - `authorityNotice`: Mandatory authority details object.
-
-### 4. `configure_prayer_preferences`
-Persists user prayer settings into Cloudflare KV.
-- **Parameters**:
-  - `userId` (string, required): Unique identifier for the user.
-  - `method` (string, optional): `'UmmAlQura'`, `'Egyptian'`, `'MuslimWorldLeague'`, `'Dubai'`, `'Qatar'`, `'Kuwait'`, `'Turkey'`, `'Karachi'`, `'NorthAmerica'`, `'Singapore'`, `'Tehran'`.
-  - `madhab` (string, optional): `'shafi'` or `'hanafi'`.
-  - `reminderMode` (string, optional): `'gentle'`, `'standard'`, `'persistent'`.
-  - `latitude` / `longitude` / `timezone` (optional): Pin a permanent fixed location.
-  - `language` (string, optional): `'en'` or `'ar'`.
-
-### 5. `get_prayer_preferences`
-Inspects stored preferences in KV for a given `userId`.
-
----
-
-## Automatic Geographic Authority Resolution Matrix
-
-When the user has not explicitly configured a preferred method, the system automatically resolves the calculation authority based on location coordinates and timezone:
-
-| Region / Location | Resolved Authority | Jurisdictional Reason / Solar Offsets | Madhab |
-| :--- | :--- | :--- | :--- |
-| **Palestine** (Gaza, West Bank, Jerusalem) | Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets) | Official Palestinian Awqaf standard: Egyptian Survey (`19.5°`/`17.5°`) with `{ maghrib: +3 min, dhuhr: -1 min }` safety offsets matching local mosque calendars. | Shafi |
-| **Saudi Arabia** | Umm al-Qura University, Makkah | Official Saudi government standard: Fajr `18.5°`, Isha `90 min` after Maghrib. | Shafi |
-| **United Arab Emirates** | General Authority of Islamic Affairs & Endowments (Awqaf UAE) | Official UAE standard (`Dubai` method): Fajr `18.2°`, Isha `18.2°`. | Shafi |
-| **Qatar** | Ministry of Endowments and Islamic Affairs (Awqaf Qatar) | Official Qatari standard: Fajr `18.0°`, Isha `90 min` after Maghrib. | Shafi |
-| **Kuwait** | Ministry of Awqaf and Islamic Affairs (Kuwait) | Official Kuwaiti standard: Fajr `18.0°`, Isha `17.5°`. | Shafi |
-| **Egypt** | Egyptian General Authority of Survey | Official Egyptian standard: Fajr `19.5°`, Isha `17.5°`. | Shafi |
-| **Turkey & Balkans** | Diyanet İşleri Başkanlığı (Turkey) | Official Turkish Presidency of Religious Affairs standard: Fajr `18.0°`, Isha `17.0°`, Hanafi Asr. | Hanafi |
-| **South Asia** (PK, IN, BD, AF) | University of Islamic Sciences, Karachi | Standard South Asian Hanafi method: Fajr `18.0°`, Isha `18.0°`, Hanafi Asr shadow ratio 2x. | Hanafi |
-| **North America** (US, CA) | Islamic Society of North America (ISNA) | Continental North American standard: Fajr `15.0°`, Isha `15.0°`. | Shafi |
-| **Southeast Asia** (SG, MY, ID, BN) | MUIS / JAKIM / MABIMS | Standard Southeast Asian regional authority: Fajr `20.0°`, Isha `18.0°`. | Shafi |
-| **Global / Other** | Muslim World League (MWL) | International consensus baseline: Fajr `18.0°`, Isha `17.0°`. | Shafi |
-
----
-
-## Required Response Formatting
-
-When generating user-facing responses containing prayer times or alerts, format the output cleanly:
-
-### Example 1: Timetable Query
-```markdown
-### Today's Prayer Times for Gaza (Friday, Sep 4, 2026)
-
-| Prayer | Time |
-| :--- | :--- |
-| **Fajr** | 04:49 AM |
-| **Sunrise** | 06:20 AM |
-| **Dhuhr** | 12:41 PM |
-| **Asr** | 04:15 PM |
-| **Maghrib** | 07:05 PM |
-| **Isha** | 08:23 PM |
-
-> **Calculation Authority**: Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets)
-> **Authority Selection Reason**: Automatically selected based on detected Palestine coordinates (31.50, 34.46) with official Awqaf solar safety adjustments (+3m Maghrib, -1m Dhuhr).
-```
-
-### Example 2: Next Prayer / Status Query
-```markdown
-🕌 **Next Prayer**: **Maghrib** in **42 minutes** (07:05 PM).
-
-> **Calculation Method**: Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets)
-> **Selection Reason**: Automatically calibrated for Palestine/Gaza location.
-```
-
----
-
-## Error Handling & Fallbacks
-- If coordinates are unavailable, the MCP automatically uses client headers (`X-User-Coordinates`, `CF-Connecting-IP`, `request.cf.timezone`), or user preferences.
-- If completely unresolved, it safely defaults to Makkah (`21.42, 39.83`, `Asia/Riyadh`, `UmmAlQura`) and notes the fallback in `authorityNotice.selectionReason`.
-- Polar/high-latitude locations (>48°) automatically engage nearest-latitude fiqh clamping to prevent invalid twilight calculations.
+---
+name: muslim-prayer-mcp
+description: Query prayer times and status using verified user location; explain calculation authority and applied approximations.
+---
+
+# Muslim Prayer Reminder MCP
+
+Generated from src/mcp/schemas.ts by scripts/generate-skill.mjs. Regenerate with npm run docs:generate; verify with npm run docs:check.
+
+## Location and error handling
+
+Use an explicit supported city, a latitude/longitude pair with an IANA timezone, or a stored complete fixed location. Explicit per-call location overrides stored settings. Supply city or coordinates, never both. Explicit coordinates require timezone in the same request; a stored timezone or a standalone timezone header is never paired with new explicit coordinates. City timezones must match the canonical city zone or its IANA alias. Coordinates are validated using an approximate offline timezone lookup and nearby boundary cells; default authority follows the geographic lookup rather than the supplied display zone. Contradictions return location_timezone_mismatch with expectedTimezone. Only exact latitude +90 or -90 permits an arbitrary explicit civil timezone with polar_choice disclosure. Other polar coordinates follow ordinary coordinate validation. Ocean cells require the canonical matching nautical zone or a civil zone found in the approximate ±0.05-degree boundary neighborhood; matching UTC offsets alone is insufficient. Disclose calculationDetails.timezoneValidation and the approximate lookup limits. Trusted host headers may supply end-user coordinates/timezone or a supported city. Never infer the user location from connector/server IP or Cloudflare network geolocation. A timezone alone cannot locate the user.
+
+If a prayer tool returns isError:true and structuredContent.code is location_required, ask for a supported city or coordinates/timezone. Do not substitute Makkah or guess a location. If code is invalid_calculation, ask the user to correct a nonexistent local date or minute adjustments that reverse prayer windows. For invalid_location or location_timezone_mismatch, correct the conflicting location/timezone; never guess. For invalid_preferences, correct the configuration; failed transactions save nothing. When a fixed location is configured, calculation-setting changes must produce an ordered timetable on the current and next local day before they are saved. Rejected combinations preserve the previous preferences. This check is not a guarantee for every future season or travel destination; query-time chronology validation remains mandatory. Auto-travel settings without a current fixed location are validated when location is supplied to a prayer query.
+
+Public coordinates are rounded before calculation/storage and never echoed. Preferences expose fixedCoordinatesConfigured/fixedCityConfigured indicators. Read-only prayer queries do not return user identifiers.
+
+Always disclose authorityNotice.authorityDescription and authorityNotice.selectionReason. When highLatitudeAdjustment.applied is true, also disclose its explanation: clamped sunrise/sunset are substitutes, not observed local events. calculationDetails explains timezone source, location basis, overrides, regional/custom/method offsets, and calendar alignment. Use the actual returned values; never invent timings or transformations.
+
+MCP endpoint: https://muslim-prayer-mcp.najetareqz.workers.dev/mcp
+Local runner: npx -y muslim-prayer-mcp
+Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity.
+
+## Status response layout
+
+get_prayer_status and REST /api/status keep detailed provenance in top-level calculationDetails/highLatitudeAdjustment. authorityNotice contains the mandatory authority/selection/display notice without duplicating those objects. nextPrayerCalculation always names the next event's localDate. When usesCurrentCalculation is true, use the top-level metadata for that event; otherwise use its own distinct metadata. Do not interpret omitted inherited adjustments as no adjustment. Other prayer tools retain their full timetable/next-prayer contracts. MCP responses preserve structuredContent plus a compact JSON text fallback; clients should consume one representation, not concatenate both.
+
+## Tool contracts
+
+Omitted preference fields preserve existing settings. Fixed mode requires a supported fixedCity or fixedCoordinates plus timezone. New coordinates require timezone in the same configuration request. auto_travel does not discover location: the caller supplies its current city or coordinates/timezone on each request; method preferences still follow the user. Switching to auto_travel preserves the saved fixed location for later reuse; clearFixedLocation:true removes the saved city, coordinates and timezone and defaults to auto_travel, preserving other preferences. Clear cannot be combined with a replacement location/timezone or incomplete fixed mode. Fixed city configurations store their canonical city timezone; contradictory supplied timezones are rejected before saving. New preferences inherit geographic/service defaults. exact_window defaults to the saved duration, or the service default of 20 minutes when unset (operators may override it). Omitting the duration does not reset an existing value. Status calls with userId can write expiring deduplication markers; persistent mode bypasses deduplication, and enabled:false suppresses reminders. For identified users, prayer_window and exact_window emit once per prayer/date/mode; changing locale or disabling/re-enabling does not reset the marker. Anonymous calls have no persistent deduplication. expiresAtUtc is the legacy prayer period end; prayerWindowExpiresAtUtc names that same boundary, while reminderWindowExpiresAtUtc is the exact eligibility end capped by the prayer period. Expiry fields appear when a reminder is emitted. KV deduplication and partial preference updates are best effort across regions.
+
+### get_prayer_status
+
+Input
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |
+| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |
+| `latitude` | number | optional | Optional explicit latitude override |
+| `longitude` | number | optional | Optional explicit longitude override |
+| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |
+| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |
+
+Output
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `nextPrayerCalculation` | object | optional | Adjustment disclosure for the actual schedule of the next event, including tomorrow |
+| `nextPrayerCalculation.localDate` | string | required |  |
+| `nextPrayerCalculation.usesCurrentCalculation` | boolean | required | If true, this next event uses the top-level calculationDetails, highLatitudeAdjustment and authorityNotice; duplicate fields are omitted. Otherwise its own distinct metadata is included. |
+| `nextPrayerCalculation.highLatitudeAdjustment` | object | optional |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.applied` | boolean | required |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `nextPrayerCalculation.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `nextPrayerCalculation.highLatitudeAdjustment.explanation` | string | required |  |
+| `nextPrayerCalculation.calculationDetails` | object | optional |  |
+| `nextPrayerCalculation.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `nextPrayerCalculation.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `nextPrayerCalculation.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `nextPrayerCalculation.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `nextPrayerCalculation.calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `nextPrayerCalculation.calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `nextPrayerCalculation.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `nextPrayerCalculation.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `nextPrayerCalculation.calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `nextPrayerCalculation.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `nextPrayerCalculation.authorityNotice` | object | optional |  |
+| `nextPrayerCalculation.authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |
+| `nextPrayerCalculation.authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |
+| `nextPrayerCalculation.authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |
+| `nextPrayerCalculation.authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |
+| `nextPrayerCalculation.authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |
+| `reminderDue` | boolean | required | Whether a prayer is currently due for reminder |
+| `prayer` | string | optional | The name of the currently due prayer if applicable |
+| `localDate` | string | required | Current local date in YYYY-MM-DD |
+| `startedAtUtc` | string | optional | UTC start time of the active prayer window |
+| `expiresAtUtc` | string | optional | UTC expiration time of the active prayer window |
+| `prayerWindowExpiresAtUtc` | string | optional | End of the active prayer period; same boundary as legacy expiresAtUtc |
+| `reminderWindowExpiresAtUtc` | string | optional | Reminder eligibility end; exact_window is capped by the prayer period boundary. Fields appear when a reminder is emitted. |
+| `nextPrayer` | string | required | The name of the next upcoming prayer |
+| `nextPrayerAtUtc` | string | required | UTC timestamp of the next upcoming prayer |
+| `timezone` | string | required | Resolved IANA timezone |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |
+| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |
+| `minuteAdjustments` | object | optional | Applied minute adjustments |
+| `minuteAdjustments.fajr` | integer | optional |  |
+| `minuteAdjustments.sunrise` | integer | optional |  |
+| `minuteAdjustments.dhuhr` | integer | optional |  |
+| `minuteAdjustments.asr` | integer | optional |  |
+| `minuteAdjustments.maghrib` | integer | optional |  |
+| `minuteAdjustments.isha` | integer | optional |  |
+| `authorityDescription` | string | optional | Description of the calculation authority |
+| `selectionReason` | string | optional | Reason for authority selection |
+| `highLatitudeAdjustment` | object | optional |  |
+| `highLatitudeAdjustment.applied` | boolean | required |  |
+| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `highLatitudeAdjustment.explanation` | string | required |  |
+| `calculationDetails` | object | optional |  |
+| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `authorityNotice` | object | required | Mandatory theological transparency notice; detailed provenance is at top level |
+| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |
+| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |
+| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |
+| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |
+| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |
+| `reminderText` | string | optional | Localized reminder message |
+
+### get_today_prayer_times
+
+Input
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |
+| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |
+| `date` | string | optional | Date in YYYY-MM-DD format (defaults to today) |
+| `latitude` | number | optional | Optional explicit latitude override |
+| `longitude` | number | optional | Optional explicit longitude override |
+| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |
+| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |
+
+Output
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `localDate` | string | required | Local schedule date YYYY-MM-DD |
+| `timezone` | string | required | Resolved IANA timezone |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |
+| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |
+| `minuteAdjustments` | object | optional |  |
+| `minuteAdjustments.fajr` | integer | optional |  |
+| `minuteAdjustments.sunrise` | integer | optional |  |
+| `minuteAdjustments.dhuhr` | integer | optional |  |
+| `minuteAdjustments.asr` | integer | optional |  |
+| `minuteAdjustments.maghrib` | integer | optional |  |
+| `minuteAdjustments.isha` | integer | optional |  |
+| `authorityDescription` | string | optional |  |
+| `selectionReason` | string | optional |  |
+| `highLatitudeAdjustment` | object | optional |  |
+| `highLatitudeAdjustment.applied` | boolean | required |  |
+| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `highLatitudeAdjustment.explanation` | string | required |  |
+| `calculationDetails` | object | optional |  |
+| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `authorityNotice` | object | optional |  |
+| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |
+| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |
+| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |
+| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |
+| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |
+| `authorityNotice.highLatitudeAdjustment` | object | optional |  |
+| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |
+| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |
+| `authorityNotice.calculationDetails` | object | optional |  |
+| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `timesUtc` | object | required |  |
+| `timesUtc.fajr` | string | required | Fajr UTC timestamp |
+| `timesUtc.sunrise` | string | required | Sunrise UTC timestamp |
+| `timesUtc.dhuhr` | string | required | Dhuhr UTC timestamp |
+| `timesUtc.asr` | string | required | Asr UTC timestamp |
+| `timesUtc.maghrib` | string | required | Maghrib UTC timestamp |
+| `timesUtc.isha` | string | required | Isha UTC timestamp |
+| `timesLocal` | object | required |  |
+| `timesLocal.Fajr` | string | required | Fajr local 24h time HH:mm |
+| `timesLocal.Sunrise` | string | required | Sunrise local 24h time HH:mm |
+| `timesLocal.Dhuhr` | string | required | Dhuhr local 24h time HH:mm |
+| `timesLocal.Asr` | string | required | Asr local 24h time HH:mm |
+| `timesLocal.Maghrib` | string | required | Maghrib local 24h time HH:mm |
+| `timesLocal.Isha` | string | required | Isha local 24h time HH:mm |
+
+### get_next_prayer
+
+Input
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |
+| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |
+| `latitude` | number | optional | Optional explicit latitude override |
+| `longitude` | number | optional | Optional explicit longitude override |
+| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |
+| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |
+
+Output
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `currentLocalDate` | string | required | Current local date YYYY-MM-DD |
+| `timezone` | string | required | Resolved IANA timezone |
+| `nextPrayer` | string | required | Name of the upcoming prayer |
+| `nextPrayerAtUtc` | string | required | UTC timestamp of the upcoming prayer |
+| `nextPrayerLocalTime` | string | required | Formatted local time HH:mm |
+| `remainingMinutes` | integer | required | Minutes remaining until prayer start |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |
+| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |
+| `authorityDescription` | string | optional |  |
+| `selectionReason` | string | optional |  |
+| `highLatitudeAdjustment` | object | optional |  |
+| `highLatitudeAdjustment.applied` | boolean | required |  |
+| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `highLatitudeAdjustment.explanation` | string | required |  |
+| `calculationDetails` | object | optional |  |
+| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `authorityNotice` | object | optional |  |
+| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |
+| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |
+| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |
+| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |
+| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |
+| `authorityNotice.highLatitudeAdjustment` | object | optional |  |
+| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |
+| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |
+| `authorityNotice.calculationDetails` | object | optional |  |
+| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
+| `minuteAdjustments` | object | optional |  |
+| `minuteAdjustments.fajr` | integer | optional |  |
+| `minuteAdjustments.sunrise` | integer | optional |  |
+| `minuteAdjustments.dhuhr` | integer | optional |  |
+| `minuteAdjustments.asr` | integer | optional |  |
+| `minuteAdjustments.maghrib` | integer | optional |  |
+| `minuteAdjustments.isha` | integer | optional |  |
+
+### configure_prayer_preferences
+
+Input
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `clearFixedLocation` | boolean | optional | Remove stored fixedCity, fixedCoordinates and timezone. Switches to auto_travel unless locationMode is supplied. Cannot combine with a new fixed location/timezone. |
+| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |
+| `locationMode` | `auto_travel`, `fixed` | optional | Location strategy: fixed uses saved location; auto_travel requires the caller to supply current city or coordinates/timezone on each query and never uses IP geolocation. |
+| `fixedCity` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |
+| `fixedCoordinates` | object | optional | Fixed geographical coordinates |
+| `fixedCoordinates.latitude` | number | required |  |
+| `fixedCoordinates.longitude` | number | required |  |
+| `timezone` | string | optional | IANA timezone identifier (e.g. Asia/Riyadh, Europe/London) |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Islamic prayer calculation authority |
+| `madhab` | `Shafi`, `Hanafi` | optional | Jurisprudential Asr shadow calculation: Shafi or Hanafi |
+| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional | High latitude twilight adjustment rule |
+| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional | Reminder display policy: prayer_window, exact_window, persistent |
+| `exactWindowMinutes` | integer | optional | Duration in minutes for exact_window mode. Omitted updates preserve the saved value; if unset, the service default is 20 minutes unless the operator overrides it. |
+| `locale` | `en`, `ar` | optional | Language for reminder text: en or ar |
+| `minuteAdjustments` | object | optional | Custom per-prayer minute offsets (-60 to +60). For fixed locations, combined settings must preserve timetable chronology for the current and next local day before saving; auto-travel offsets are validated when a query supplies its location. |
+| `minuteAdjustments.fajr` | integer | optional |  |
+| `minuteAdjustments.sunrise` | integer | optional |  |
+| `minuteAdjustments.dhuhr` | integer | optional |  |
+| `minuteAdjustments.asr` | integer | optional |  |
+| `minuteAdjustments.maghrib` | integer | optional |  |
+| `minuteAdjustments.isha` | integer | optional |  |
+| `enabled` | boolean | optional | Whether prayer reminders are enabled |
+
+Output
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `success` | boolean | required | Whether configuration succeeded |
+| `preferences` | object | required |  |
+| `preferences.fixedCoordinatesConfigured` | boolean | required |  |
+| `preferences.fixedCityConfigured` | boolean | required |  |
+| `preferences.locationMode` | `auto_travel`, `fixed` | optional |  |
+| `preferences.fixedCity` | string | optional |  |
+| `preferences.timezone` | string | optional |  |
+| `preferences.calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |
+| `preferences.madhab` | `Shafi`, `Hanafi` | optional |  |
+| `preferences.highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |
+| `preferences.reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |
+| `preferences.exactWindowMinutes` | number | optional |  |
+| `preferences.locale` | `en`, `ar` | optional |  |
+| `preferences.minuteAdjustments` | object | optional |  |
+| `preferences.minuteAdjustments.fajr` | integer | optional |  |
+| `preferences.minuteAdjustments.sunrise` | integer | optional |  |
+| `preferences.minuteAdjustments.dhuhr` | integer | optional |  |
+| `preferences.minuteAdjustments.asr` | integer | optional |  |
+| `preferences.minuteAdjustments.maghrib` | integer | optional |  |
+| `preferences.minuteAdjustments.isha` | integer | optional |  |
+| `preferences.enabled` | boolean | optional |  |
+| `preferences.updatedAtUtc` | string | optional |  |
+| `preferences.message` | string | optional |  |
+
+### get_prayer_preferences
+
+Input
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |
+
+Output
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `fixedCoordinatesConfigured` | boolean | required |  |
+| `fixedCityConfigured` | boolean | required |  |
+| `locationMode` | `auto_travel`, `fixed` | optional |  |
+| `fixedCity` | string | optional |  |
+| `timezone` | string | optional |  |
+| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |
+| `madhab` | `Shafi`, `Hanafi` | optional |  |
+| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |
+| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |
+| `exactWindowMinutes` | number | optional |  |
+| `locale` | `en`, `ar` | optional |  |
+| `minuteAdjustments` | object | optional |  |
+| `minuteAdjustments.fajr` | integer | optional |  |
+| `minuteAdjustments.sunrise` | integer | optional |  |
+| `minuteAdjustments.dhuhr` | integer | optional |  |
+| `minuteAdjustments.asr` | integer | optional |  |
+| `minuteAdjustments.maghrib` | integer | optional |  |
+| `minuteAdjustments.isha` | integer | optional |  |
+| `enabled` | boolean | optional |  |
+| `updatedAtUtc` | string | optional |  |
+| `message` | string | optional |  |
+
+The `preferences` configuration result uses the same fields as `get_prayer_preferences`. Nested disclosure objects are defined below once for all prayer tools.
+
+## highLatitudeAdjustment
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `applied` | boolean | required |  |
+| `rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `astronomicalLatitudeClamped` | boolean | required |  |
+| `effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `explanation` | string | required |  |
+
+## calculationDetails
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `locationIsApproximate` | boolean | optional |  |
+| `fallbackLocationUsed` | boolean | optional |  |
+| `methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `regionalMinuteAdjustments` | object | optional |  |
+| `regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `regionalMinuteAdjustments.asr` | integer | optional |  |
+| `regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `regionalMinuteAdjustments.isha` | integer | optional |  |
+| `customMinuteAdjustments` | object | optional |  |
+| `customMinuteAdjustments.fajr` | integer | optional |  |
+| `customMinuteAdjustments.sunrise` | integer | optional |  |
+| `customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `customMinuteAdjustments.asr` | integer | optional |  |
+| `customMinuteAdjustments.maghrib` | integer | optional |  |
+| `customMinuteAdjustments.isha` | integer | optional |  |
+| `methodMinuteAdjustments` | object | optional |  |
+| `methodMinuteAdjustments.fajr` | integer | optional |  |
+| `methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `methodMinuteAdjustments.asr` | integer | optional |  |
+| `methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `methodMinuteAdjustments.isha` | integer | optional |  |
+| `appliedMinuteAdjustments` | object | optional |  |
+| `calendarAlignmentAdjusted` | boolean | optional |  |
+
+## authorityNotice
+
+| Field | Type / allowed values | Presence | Description |
+| --- | --- | --- | --- |
+| `method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |
+| `madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |
+| `authorityDescription` | string | required | Full descriptive name of the calculation authority |
+| `selectionReason` | string | required | Rationale for selecting this authority |
+| `requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |
+| `highLatitudeAdjustment` | object | optional |  |
+| `highLatitudeAdjustment.applied` | boolean | required |  |
+| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |
+| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |
+| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |
+| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |
+| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |
+| `highLatitudeAdjustment.explanation` | string | required |  |
+| `calculationDetails` | object | optional |  |
+| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |
+| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |
+| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |
+| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |
+| `calculationDetails.locationIsApproximate` | boolean | optional |  |
+| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |
+| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |
+| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments` | object | optional |  |
+| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments` | object | optional |  |
+| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |
+| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |
+| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |
+| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |
Full technical diff · 2 changed fields

changed /description

BEFORE
"Teaches LLMs how to query Muslim prayer times, check current prayer due status, countdown to next prayer, and enforce mandatory calculation authority and selection justification disclosure."
AFTER
"Query prayer times and status using verified user location; explain calculation authority and applied approximations."

changed /skill_md_contents

BEFORE
"---\nname: muslim-prayer-mcp\ndescription: Teaches LLMs how to query Muslim prayer times, check current prayer due status, countdown to next prayer, and enforce mandatory calculation authority and selection justification disclosure.\n---\n\n# Muslim Prayer Reminder MCP\n\nThis skill instructs LLMs (Claude, GPT, Cursor, Copilot, Gemini, Devin, etc.) on interacting with the Muslim Prayer Reminder MCP server (`muslim-prayer-mcp`), executing prayer-time tools, interpreting results, and formatting prayer outputs.\n\n## Server Endpoints\n- **Streamable HTTP (Remote Worker)**: `https://muslim-prayer-mcp.najetareqz.workers.dev/mcp`\n- **Local Stdio (NPX)**: `npx -y muslim-prayer-mcp`\n\n---\n\n## ⚠️ MANDATORY DIRECTIVE: Authority and Selection Reason Disclosure\n\nEvery time you present prayer times, next prayer countdowns, or prayer status to a user, you **MUST EXPLICITLY STATE**:\n1. **The calculation authority and method used** (e.g., Palestinian Ministry of Awqaf, Umm al-Qura University Makkah, Egyptian General Authority of Survey, Diyanet İşleri Başkanlığı, etc.).\n2. **Why that authority was selected** (e.g., automatically selected based on Gaza/Palestine coordinates with regional Awqaf safety offsets, matched user timezone Asia/Riyadh, user explicitly configured method, etc.).\n\n**Zero Exception Rule**: Never omit this disclosure. The `authorityNotice` object returned in all tool payloads contains the exact strings to use.\n\n---\n\n## Tool Reference\n\n### 1. `get_prayer_status`\nChecks if an obligatory prayer (Fajr, Dhuhr, Asr, Maghrib, Isha) is currently due within the active reminder window.\n- **Parameters**:\n  - `userId` (string, optional): User ID for fetching stored preferences. Default: `'default_user'`.\n  - `lat` (number, optional): Latitude in decimal degrees (e.g., `31.50`).\n  - `lng` (number, optional): Longitude in decimal degrees (e.g., `34.46`).\n  - `timezone` (string, optional): IANA timezone identifier (e.g., `'Asia/Gaza'`).\n- **Response Shape**:\n  - `due` (boolean): `true` if a prayer is within its active reminder window.\n  - `prayer` (string | null): Name of the prayer due (`'Fajr'`, `'Dhuhr'`, `'Asr'`, `'Maghrib'`, `'Isha'`).\n  - `message` (string | null): Localized alert message (e.g., `\"It is time for Maghrib prayer.\"`).\n  - `prayerTimeUtc` / `prayerTimeFormatted`: Timestamp of the prayer.\n  - `authorityNotice`: Mandatory authority details object.\n\n### 2. `get_today_prayer_times`\nRetrieves today's complete prayer schedule: Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha.\n- **Parameters**: `userId`, `lat`, `lng`, `timezone`.\n- **Response Shape**:\n  - `date`: Date string (`YYYY-MM-DD`).\n  - `timezone`: Active IANA timezone.\n  - `method`: Calculation method identifier.\n  - `madhab`: Madhab used for Asr calculation (`'shafi'` or `'hanafi'`).\n  - `times`: Map of prayers to `{ utc: ISOString, formatted: \"HH:MM\" }`.\n  - `authorityNotice`: Mandatory authority details object.\n\n### 3. `get_next_prayer`\nIdentifies the upcoming prayer and remaining countdown time in minutes.\n- **Parameters**: `userId`, `lat`, `lng`, `timezone`.\n- **Response Shape**:\n  - `currentPrayer`: Currently ongoing prayer period.\n  - `nextPrayer`: Name of the next incoming prayer.\n  - `nextPrayerTimeFormatted`: Formatted local time.\n  - `minutesRemaining`: Minutes until prayer time.\n  - `authorityNotice`: Mandatory authority details object.\n\n### 4. `configure_prayer_preferences`\nPersists user prayer settings into Cloudflare KV.\n- **Parameters**:\n  - `userId` (string, required): Unique identifier for the user.\n  - `method` (string, optional): `'UmmAlQura'`, `'Egyptian'`, `'MuslimWorldLeague'`, `'Dubai'`, `'Qatar'`, `'Kuwait'`, `'Turkey'`, `'Karachi'`, `'NorthAmerica'`, `'Singapore'`, `'Tehran'`.\n  - `madhab` (string, optional): `'shafi'` or `'hanafi'`.\n  - `reminderMode` (string, optional): `'gentle'`, `'standard'`, `'persistent'`.\n  - `latitude` / `longitude` / `timezone` (optional): Pin a permanent fixed location.\n  - `language` (string, optional): `'en'` or `'ar'`.\n\n### 5. `get_prayer_preferences`\nInspects stored preferences in KV for a given `userId`.\n\n---\n\n## Automatic Geographic Authority Resolution Matrix\n\nWhen the user has not explicitly configured a preferred method, the system automatically resolves the calculation authority based on location coordinates and timezone:\n\n| Region / Location | Resolved Authority | Jurisdictional Reason / Solar Offsets | Madhab |\n| :--- | :--- | :--- | :--- |\n| **Palestine** (Gaza, West Bank, Jerusalem) | Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets) | Official Palestinian Awqaf standard: Egyptian Survey (`19.5°`/`17.5°`) with `{ maghrib: +3 min, dhuhr: -1 min }` safety offsets matching local mosque calendars. | Shafi |\n| **Saudi Arabia** | Umm al-Qura University, Makkah | Official Saudi government standard: Fajr `18.5°`, Isha `90 min` after Maghrib. | Shafi |\n| **United Arab Emirates** | General Authority of Islamic Affairs & Endowments (Awqaf UAE) | Official UAE standard (`Dubai` method): Fajr `18.2°`, Isha `18.2°`. | Shafi |\n| **Qatar** | Ministry of Endowments and Islamic Affairs (Awqaf Qatar) | Official Qatari standard: Fajr `18.0°`, Isha `90 min` after Maghrib. | Shafi |\n| **Kuwait** | Ministry of Awqaf and Islamic Affairs (Kuwait) | Official Kuwaiti standard: Fajr `18.0°`, Isha `17.5°`. | Shafi |\n| **Egypt** | Egyptian General Authority of Survey | Official Egyptian standard: Fajr `19.5°`, Isha `17.5°`. | Shafi |\n| **Turkey & Balkans** | Diyanet İşleri Başkanlığı (Turkey) | Official Turkish Presidency of Religious Affairs standard: Fajr `18.0°`, Isha `17.0°`, Hanafi Asr. | Hanafi |\n| **South Asia** (PK, IN, BD, AF) | University of Islamic Sciences, Karachi | Standard South Asian Hanafi method: Fajr `18.0°`, Isha `18.0°`, Hanafi Asr shadow ratio 2x. | Hanafi |\n| **North America** (US, CA) | Islamic Society of North America (ISNA) | Continental North American standard: Fajr `15.0°`, Isha `15.0°`. | Shafi |\n| **Southeast Asia** (SG, MY, ID, BN) | MUIS / JAKIM / MABIMS | Standard Southeast Asian regional authority: Fajr `20.0°`, Isha `18.0°`. | Shafi |\n| **Global / Other** | Muslim World League (MWL) | International consensus baseline: Fajr `18.0°`, Isha `17.0°`. | Shafi |\n\n---\n\n## Required Response Formatting\n\nWhen generating user-facing responses containing prayer times or alerts, format the output cleanly:\n\n### Example 1: Timetable Query\n```markdown\n### Today's Prayer Times for Gaza (Friday, Sep 4, 2026)\n\n| Prayer | Time |\n| :--- | :--- |\n| **Fajr** | 04:49 AM |\n| **Sunrise** | 06:20 AM |\n| **Dhuhr** | 12:41 PM |\n| **Asr** | 04:15 PM |\n| **Maghrib** | 07:05 PM |\n| **Isha** | 08:23 PM |\n\n> **Calculation Authority**: Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets)\n> **Authority Selection Reason**: Automatically selected based on detected Palestine coordinates (31.50, 34.46) with official Awqaf solar safety adjustments (+3m Maghrib, -1m Dhuhr).\n```\n\n### Example 2: Next Prayer / Status Query\n```markdown\n🕌 **Next Prayer**: **Maghrib** in **42 minutes** (07:05 PM).\n\n> **Calculation Method**: Palestinian Ministry of Awqaf (Egyptian Survey Authority + Awqaf Offsets)\n> **Selection Reason**: Automatically calibrated for Palestine/Gaza location.\n```\n\n---\n\n## Error Handling & Fallbacks\n- If coordinates are unavailable, the MCP automatically uses client headers (`X-User-Coordinates`, `CF-Connecting-IP`, `request.cf.timezone`), or user preferences.\n- If completely unresolved, it safely defaults to Makkah (`21.42, 39.83`, `Asia/Riyadh`, `UmmAlQura`) and notes the fallback in `authorityNotice.selectionReason`.\n- Polar/high-latitude locations (>48°) automatically engage nearest-latitude fiqh clamping to prevent invalid twilight calculations.\n"
AFTER
"---\r\nname: muslim-prayer-mcp\r\ndescription: Query prayer times and status using verified user location; explain calculation authority and applied approximations.\r\n---\r\n\r\n# Muslim Prayer Reminder MCP\r\n\r\nGenerated from src/mcp/schemas.ts by scripts/generate-skill.mjs. Regenerate with npm run docs:generate; verify with npm run docs:check.\r\n\r\n## Location and error handling\r\n\r\nUse an explicit supported city, a latitude/longitude pair with an IANA timezone, or a stored complete fixed location. Explicit per-call location overrides stored settings. Supply city or coordinates, never both. Explicit coordinates require timezone in the same request; a stored timezone or a standalone timezone header is never paired with new explicit coordinates. City timezones must match the canonical city zone or its IANA alias. Coordinates are validated using an approximate offline timezone lookup and nearby boundary cells; default authority follows the geographic lookup rather than the supplied display zone. Contradictions return location_timezone_mismatch with expectedTimezone. Only exact latitude +90 or -90 permits an arbitrary explicit civil timezone with polar_choice disclosure. Other polar coordinates follow ordinary coordinate validation. Ocean cells require the canonical matching nautical zone or a civil zone found in the approximate ±0.05-degree boundary neighborhood; matching UTC offsets alone is insufficient. Disclose calculationDetails.timezoneValidation and the approximate lookup limits. Trusted host headers may supply end-user coordinates/timezone or a supported city. Never infer the user location from connector/server IP or Cloudflare network geolocation. A timezone alone cannot locate the user.\r\n\r\nIf a prayer tool returns isError:true and structuredContent.code is location_required, ask for a supported city or coordinates/timezone. Do not substitute Makkah or guess a location. If code is invalid_calculation, ask the user to correct a nonexistent local date or minute adjustments that reverse prayer windows. For invalid_location or location_timezone_mismatch, correct the conflicting location/timezone; never guess. For invalid_preferences, correct the configuration; failed transactions save nothing. When a fixed location is configured, calculation-setting changes must produce an ordered timetable on the current and next local day before they are saved. Rejected combinations preserve the previous preferences. This check is not a guarantee for every future season or travel destination; query-time chronology validation remains mandatory. Auto-travel settings without a current fixed location are validated when location is supplied to a prayer query.\r\n\r\nPublic coordinates are rounded before calculation/storage and never echoed. Preferences expose fixedCoordinatesConfigured/fixedCityConfigured indicators. Read-only prayer queries do not return user identifiers.\r\n\r\nAlways disclose authorityNotice.authorityDescription and authorityNotice.selectionReason. When highLatitudeAdjustment.applied is true, also disclose its explanation: clamped sunrise/sunset are substitutes, not observed local events. calculationDetails explains timezone source, location basis, overrides, regional/custom/method offsets, and calendar alignment. Use the actual returned values; never invent timings or transformations.\r\n\r\nMCP endpoint: https://muslim-prayer-mcp.najetareqz.workers.dev/mcp\r\nLocal runner: npx -y muslim-prayer-mcp\r\nSupported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity.\r\n\r\n## Status response layout\r\n\r\nget_prayer_status and REST /api/status keep detailed provenance in top-level calculationDetails/highLatitudeAdjustment. authorityNotice contains the mandatory authority/selection/display notice without duplicating those objects. nextPrayerCalculation always names the next event's localDate. When usesCurrentCalculation is true, use the top-level metadata for that event; otherwise use its own distinct metadata. Do not interpret omitted inherited adjustments as no adjustment. Other prayer tools retain their full timetable/next-prayer contracts. MCP responses preserve structuredContent plus a compact JSON text fallback; clients should consume one representation, not concatenate both.\r\n\r\n## Tool contracts\r\n\r\nOmitted preference fields preserve existing settings. Fixed mode requires a supported fixedCity or fixedCoordinates plus timezone. New coordinates require timezone in the same configuration request. auto_travel does not discover location: the caller supplies its current city or coordinates/timezone on each request; method preferences still follow the user. Switching to auto_travel preserves the saved fixed location for later reuse; clearFixedLocation:true removes the saved city, coordinates and timezone and defaults to auto_travel, preserving other preferences. Clear cannot be combined with a replacement location/timezone or incomplete fixed mode. Fixed city configurations store their canonical city timezone; contradictory supplied timezones are rejected before saving. New preferences inherit geographic/service defaults. exact_window defaults to the saved duration, or the service default of 20 minutes when unset (operators may override it). Omitting the duration does not reset an existing value. Status calls with userId can write expiring deduplication markers; persistent mode bypasses deduplication, and enabled:false suppresses reminders. For identified users, prayer_window and exact_window emit once per prayer/date/mode; changing locale or disabling/re-enabling does not reset the marker. Anonymous calls have no persistent deduplication. expiresAtUtc is the legacy prayer period end; prayerWindowExpiresAtUtc names that same boundary, while reminderWindowExpiresAtUtc is the exact eligibility end capped by the prayer period. Expiry fields appear when a reminder is emitted. KV deduplication and partial preference updates are best effort across regions.\r\n\r\n### get_prayer_status\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `nextPrayerCalculation` | object | optional | Adjustment disclosure for the actual schedule of the next event, including tomorrow |\r\n| `nextPrayerCalculation.localDate` | string | required |  |\r\n| `nextPrayerCalculation.usesCurrentCalculation` | boolean | required | If true, this next event uses the top-level calculationDetails, highLatitudeAdjustment and authorityNotice; duplicate fields are omitted. Otherwise its own distinct metadata is included. |\r\n| `nextPrayerCalculation.highLatitudeAdjustment` | object | optional |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `nextPrayerCalculation.calculationDetails` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `nextPrayerCalculation.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `nextPrayerCalculation.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `nextPrayerCalculation.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `nextPrayerCalculation.authorityNotice` | object | optional |  |\r\n| `nextPrayerCalculation.authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `nextPrayerCalculation.authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `nextPrayerCalculation.authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `nextPrayerCalculation.authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `nextPrayerCalculation.authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `reminderDue` | boolean | required | Whether a prayer is currently due for reminder |\r\n| `prayer` | string | optional | The name of the currently due prayer if applicable |\r\n| `localDate` | string | required | Current local date in YYYY-MM-DD |\r\n| `startedAtUtc` | string | optional | UTC start time of the active prayer window |\r\n| `expiresAtUtc` | string | optional | UTC expiration time of the active prayer window |\r\n| `prayerWindowExpiresAtUtc` | string | optional | End of the active prayer period; same boundary as legacy expiresAtUtc |\r\n| `reminderWindowExpiresAtUtc` | string | optional | Reminder eligibility end; exact_window is capped by the prayer period boundary. Fields appear when a reminder is emitted. |\r\n| `nextPrayer` | string | required | The name of the next upcoming prayer |\r\n| `nextPrayerAtUtc` | string | required | UTC timestamp of the next upcoming prayer |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `minuteAdjustments` | object | optional | Applied minute adjustments |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `authorityDescription` | string | optional | Description of the calculation authority |\r\n| `selectionReason` | string | optional | Reason for authority selection |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | required | Mandatory theological transparency notice; detailed provenance is at top level |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `reminderText` | string | optional | Localized reminder message |\r\n\r\n### get_today_prayer_times\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `date` | string | optional | Date in YYYY-MM-DD format (defaults to today) |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `localDate` | string | required | Local schedule date YYYY-MM-DD |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `authorityDescription` | string | optional |  |\r\n| `selectionReason` | string | optional |  |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | optional |  |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `authorityNotice.highLatitudeAdjustment` | object | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `authorityNotice.calculationDetails` | object | optional |  |\r\n| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `timesUtc` | object | required |  |\r\n| `timesUtc.fajr` | string | required | Fajr UTC timestamp |\r\n| `timesUtc.sunrise` | string | required | Sunrise UTC timestamp |\r\n| `timesUtc.dhuhr` | string | required | Dhuhr UTC timestamp |\r\n| `timesUtc.asr` | string | required | Asr UTC timestamp |\r\n| `timesUtc.maghrib` | string | required | Maghrib UTC timestamp |\r\n| `timesUtc.isha` | string | required | Isha UTC timestamp |\r\n| `timesLocal` | object | required |  |\r\n| `timesLocal.Fajr` | string | required | Fajr local 24h time HH:mm |\r\n| `timesLocal.Sunrise` | string | required | Sunrise local 24h time HH:mm |\r\n| `timesLocal.Dhuhr` | string | required | Dhuhr local 24h time HH:mm |\r\n| `timesLocal.Asr` | string | required | Asr local 24h time HH:mm |\r\n| `timesLocal.Maghrib` | string | required | Maghrib local 24h time HH:mm |\r\n| `timesLocal.Isha` | string | required | Isha local 24h time HH:mm |\r\n\r\n### get_next_prayer\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `currentLocalDate` | string | required | Current local date YYYY-MM-DD |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `nextPrayer` | string | required | Name of the upcoming prayer |\r\n| `nextPrayerAtUtc` | string | required | UTC timestamp of the upcoming prayer |\r\n| `nextPrayerLocalTime` | string | required | Formatted local time HH:mm |\r\n| `remainingMinutes` | integer | required | Minutes remaining until prayer start |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `authorityDescription` | string | optional |  |\r\n| `selectionReason` | string | optional |  |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | optional |  |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `authorityNotice.highLatitudeAdjustment` | object | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `authorityNotice.calculationDetails` | object | optional |  |\r\n| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n\r\n### configure_prayer_preferences\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `clearFixedLocation` | boolean | optional | Remove stored fixedCity, fixedCoordinates and timezone. Switches to auto_travel unless locationMode is supplied. Cannot combine with a new fixed location/timezone. |\r\n| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `locationMode` | `auto_travel`, `fixed` | optional | Location strategy: fixed uses saved location; auto_travel requires the caller to supply current city or coordinates/timezone on each query and never uses IP geolocation. |\r\n| `fixedCity` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `fixedCoordinates` | object | optional | Fixed geographical coordinates |\r\n| `fixedCoordinates.latitude` | number | required |  |\r\n| `fixedCoordinates.longitude` | number | required |  |\r\n| `timezone` | string | optional | IANA timezone identifier (e.g. Asia/Riyadh, Europe/London) |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Islamic prayer calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Jurisprudential Asr shadow calculation: Shafi or Hanafi |\r\n| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional | High latitude twilight adjustment rule |\r\n| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional | Reminder display policy: prayer_window, exact_window, persistent |\r\n| `exactWindowMinutes` | integer | optional | Duration in minutes for exact_window mode. Omitted updates preserve the saved value; if unset, the service default is 20 minutes unless the operator overrides it. |\r\n| `locale` | `en`, `ar` | optional | Language for reminder text: en or ar |\r\n| `minuteAdjustments` | object | optional | Custom per-prayer minute offsets (-60 to +60). For fixed locations, combined settings must preserve timetable chronology for the current and next local day before saving; auto-travel offsets are validated when a query supplies its location. |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `enabled` | boolean | optional | Whether prayer reminders are enabled |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `success` | boolean | required | Whether configuration succeeded |\r\n| `preferences` | object | required |  |\r\n| `preferences.fixedCoordinatesConfigured` | boolean | required |  |\r\n| `preferences.fixedCityConfigured` | boolean | required |  |\r\n| `preferences.locationMode` | `auto_travel`, `fixed` | optional |  |\r\n| `preferences.fixedCity` | string | optional |  |\r\n| `preferences.timezone` | string | optional |  |\r\n| `preferences.calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |\r\n| `preferences.madhab` | `Shafi`, `Hanafi` | optional |  |\r\n| `preferences.highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |\r\n| `preferences.reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |\r\n| `preferences.exactWindowMinutes` | number | optional |  |\r\n| `preferences.locale` | `en`, `ar` | optional |  |\r\n| `preferences.minuteAdjustments` | object | optional |  |\r\n| `preferences.minuteAdjustments.fajr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.sunrise` | integer | optional |  |\r\n| `preferences.minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.asr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.maghrib` | integer | optional |  |\r\n| `preferences.minuteAdjustments.isha` | integer | optional |  |\r\n| `preferences.enabled` | boolean | optional |  |\r\n| `preferences.updatedAtUtc` | string | optional |  |\r\n| `preferences.message` | string | optional |  |\r\n\r\n### get_prayer_preferences\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `fixedCoordinatesConfigured` | boolean | required |  |\r\n| `fixedCityConfigured` | boolean | required |  |\r\n| `locationMode` | `auto_travel`, `fixed` | optional |  |\r\n| `fixedCity` | string | optional |  |\r\n| `timezone` | string | optional |  |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |\r\n| `madhab` | `Shafi`, `Hanafi` | optional |  |\r\n| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |\r\n| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |\r\n| `exactWindowMinutes` | number | optional |  |\r\n| `locale` | `en`, `ar` | optional |  |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `enabled` | boolean | optional |  |\r\n| `updatedAtUtc` | string | optional |  |\r\n| `message` | string | optional |  |\r\n\r\nThe `preferences` configuration result uses the same fields as `get_prayer_preferences`. Nested disclosure objects are defined below once for all prayer tools.\r\n\r\n## highLatitudeAdjustment\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `applied` | boolean | required |  |\r\n| `rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `astronomicalLatitudeClamped` | boolean | required |  |\r\n| `effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `explanation` | string | required |  |\r\n\r\n## calculationDetails\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `locationIsApproximate` | boolean | optional |  |\r\n| `fallbackLocationUsed` | boolean | optional |  |\r\n| `methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `regionalMinuteAdjustments` | object | optional |  |\r\n| `regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `customMinuteAdjustments` | object | optional |  |\r\n| `customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `customMinuteAdjustments.asr` | integer | optional |  |\r\n| `customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `customMinuteAdjustments.isha` | integer | optional |  |\r\n| `methodMinuteAdjustments` | object | optional |  |\r\n| `methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `appliedMinuteAdjustments` | object | optional |  |\r\n| `calendarAlignmentAdjusted` | boolean | optional |  |\r\n\r\n## authorityNotice\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `selectionReason` | string | required | Rationale for selecting this authority |\r\n| `requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n"
Full snapshot data
{
  "description": "Query prayer times and status using verified user location; explain calculation authority and applied approximations.",
  "included_files": [],
  "name": "muslim-prayer-mcp",
  "skill_md_contents": "---\r\nname: muslim-prayer-mcp\r\ndescription: Query prayer times and status using verified user location; explain calculation authority and applied approximations.\r\n---\r\n\r\n# Muslim Prayer Reminder MCP\r\n\r\nGenerated from src/mcp/schemas.ts by scripts/generate-skill.mjs. Regenerate with npm run docs:generate; verify with npm run docs:check.\r\n\r\n## Location and error handling\r\n\r\nUse an explicit supported city, a latitude/longitude pair with an IANA timezone, or a stored complete fixed location. Explicit per-call location overrides stored settings. Supply city or coordinates, never both. Explicit coordinates require timezone in the same request; a stored timezone or a standalone timezone header is never paired with new explicit coordinates. City timezones must match the canonical city zone or its IANA alias. Coordinates are validated using an approximate offline timezone lookup and nearby boundary cells; default authority follows the geographic lookup rather than the supplied display zone. Contradictions return location_timezone_mismatch with expectedTimezone. Only exact latitude +90 or -90 permits an arbitrary explicit civil timezone with polar_choice disclosure. Other polar coordinates follow ordinary coordinate validation. Ocean cells require the canonical matching nautical zone or a civil zone found in the approximate ±0.05-degree boundary neighborhood; matching UTC offsets alone is insufficient. Disclose calculationDetails.timezoneValidation and the approximate lookup limits. Trusted host headers may supply end-user coordinates/timezone or a supported city. Never infer the user location from connector/server IP or Cloudflare network geolocation. A timezone alone cannot locate the user.\r\n\r\nIf a prayer tool returns isError:true and structuredContent.code is location_required, ask for a supported city or coordinates/timezone. Do not substitute Makkah or guess a location. If code is invalid_calculation, ask the user to correct a nonexistent local date or minute adjustments that reverse prayer windows. For invalid_location or location_timezone_mismatch, correct the conflicting location/timezone; never guess. For invalid_preferences, correct the configuration; failed transactions save nothing. When a fixed location is configured, calculation-setting changes must produce an ordered timetable on the current and next local day before they are saved. Rejected combinations preserve the previous preferences. This check is not a guarantee for every future season or travel destination; query-time chronology validation remains mandatory. Auto-travel settings without a current fixed location are validated when location is supplied to a prayer query.\r\n\r\nPublic coordinates are rounded before calculation/storage and never echoed. Preferences expose fixedCoordinatesConfigured/fixedCityConfigured indicators. Read-only prayer queries do not return user identifiers.\r\n\r\nAlways disclose authorityNotice.authorityDescription and authorityNotice.selectionReason. When highLatitudeAdjustment.applied is true, also disclose its explanation: clamped sunrise/sunset are substitutes, not observed local events. calculationDetails explains timezone source, location basis, overrides, regional/custom/method offsets, and calendar alignment. Use the actual returned values; never invent timings or transformations.\r\n\r\nMCP endpoint: https://muslim-prayer-mcp.najetareqz.workers.dev/mcp\r\nLocal runner: npx -y muslim-prayer-mcp\r\nSupported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity.\r\n\r\n## Status response layout\r\n\r\nget_prayer_status and REST /api/status keep detailed provenance in top-level calculationDetails/highLatitudeAdjustment. authorityNotice contains the mandatory authority/selection/display notice without duplicating those objects. nextPrayerCalculation always names the next event's localDate. When usesCurrentCalculation is true, use the top-level metadata for that event; otherwise use its own distinct metadata. Do not interpret omitted inherited adjustments as no adjustment. Other prayer tools retain their full timetable/next-prayer contracts. MCP responses preserve structuredContent plus a compact JSON text fallback; clients should consume one representation, not concatenate both.\r\n\r\n## Tool contracts\r\n\r\nOmitted preference fields preserve existing settings. Fixed mode requires a supported fixedCity or fixedCoordinates plus timezone. New coordinates require timezone in the same configuration request. auto_travel does not discover location: the caller supplies its current city or coordinates/timezone on each request; method preferences still follow the user. Switching to auto_travel preserves the saved fixed location for later reuse; clearFixedLocation:true removes the saved city, coordinates and timezone and defaults to auto_travel, preserving other preferences. Clear cannot be combined with a replacement location/timezone or incomplete fixed mode. Fixed city configurations store their canonical city timezone; contradictory supplied timezones are rejected before saving. New preferences inherit geographic/service defaults. exact_window defaults to the saved duration, or the service default of 20 minutes when unset (operators may override it). Omitting the duration does not reset an existing value. Status calls with userId can write expiring deduplication markers; persistent mode bypasses deduplication, and enabled:false suppresses reminders. For identified users, prayer_window and exact_window emit once per prayer/date/mode; changing locale or disabling/re-enabling does not reset the marker. Anonymous calls have no persistent deduplication. expiresAtUtc is the legacy prayer period end; prayerWindowExpiresAtUtc names that same boundary, while reminderWindowExpiresAtUtc is the exact eligibility end capped by the prayer period. Expiry fields appear when a reminder is emitted. KV deduplication and partial preference updates are best effort across regions.\r\n\r\n### get_prayer_status\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `nextPrayerCalculation` | object | optional | Adjustment disclosure for the actual schedule of the next event, including tomorrow |\r\n| `nextPrayerCalculation.localDate` | string | required |  |\r\n| `nextPrayerCalculation.usesCurrentCalculation` | boolean | required | If true, this next event uses the top-level calculationDetails, highLatitudeAdjustment and authorityNotice; duplicate fields are omitted. Otherwise its own distinct metadata is included. |\r\n| `nextPrayerCalculation.highLatitudeAdjustment` | object | optional |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `nextPrayerCalculation.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `nextPrayerCalculation.calculationDetails` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `nextPrayerCalculation.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `nextPrayerCalculation.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `nextPrayerCalculation.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `nextPrayerCalculation.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `nextPrayerCalculation.authorityNotice` | object | optional |  |\r\n| `nextPrayerCalculation.authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `nextPrayerCalculation.authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `nextPrayerCalculation.authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `nextPrayerCalculation.authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `nextPrayerCalculation.authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `reminderDue` | boolean | required | Whether a prayer is currently due for reminder |\r\n| `prayer` | string | optional | The name of the currently due prayer if applicable |\r\n| `localDate` | string | required | Current local date in YYYY-MM-DD |\r\n| `startedAtUtc` | string | optional | UTC start time of the active prayer window |\r\n| `expiresAtUtc` | string | optional | UTC expiration time of the active prayer window |\r\n| `prayerWindowExpiresAtUtc` | string | optional | End of the active prayer period; same boundary as legacy expiresAtUtc |\r\n| `reminderWindowExpiresAtUtc` | string | optional | Reminder eligibility end; exact_window is capped by the prayer period boundary. Fields appear when a reminder is emitted. |\r\n| `nextPrayer` | string | required | The name of the next upcoming prayer |\r\n| `nextPrayerAtUtc` | string | required | UTC timestamp of the next upcoming prayer |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `minuteAdjustments` | object | optional | Applied minute adjustments |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `authorityDescription` | string | optional | Description of the calculation authority |\r\n| `selectionReason` | string | optional | Reason for authority selection |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | required | Mandatory theological transparency notice; detailed provenance is at top level |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `reminderText` | string | optional | Localized reminder message |\r\n\r\n### get_today_prayer_times\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `date` | string | optional | Date in YYYY-MM-DD format (defaults to today) |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `localDate` | string | required | Local schedule date YYYY-MM-DD |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `authorityDescription` | string | optional |  |\r\n| `selectionReason` | string | optional |  |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | optional |  |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `authorityNotice.highLatitudeAdjustment` | object | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `authorityNotice.calculationDetails` | object | optional |  |\r\n| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `timesUtc` | object | required |  |\r\n| `timesUtc.fajr` | string | required | Fajr UTC timestamp |\r\n| `timesUtc.sunrise` | string | required | Sunrise UTC timestamp |\r\n| `timesUtc.dhuhr` | string | required | Dhuhr UTC timestamp |\r\n| `timesUtc.asr` | string | required | Asr UTC timestamp |\r\n| `timesUtc.maghrib` | string | required | Maghrib UTC timestamp |\r\n| `timesUtc.isha` | string | required | Isha UTC timestamp |\r\n| `timesLocal` | object | required |  |\r\n| `timesLocal.Fajr` | string | required | Fajr local 24h time HH:mm |\r\n| `timesLocal.Sunrise` | string | required | Sunrise local 24h time HH:mm |\r\n| `timesLocal.Dhuhr` | string | required | Dhuhr local 24h time HH:mm |\r\n| `timesLocal.Asr` | string | required | Asr local 24h time HH:mm |\r\n| `timesLocal.Maghrib` | string | required | Maghrib local 24h time HH:mm |\r\n| `timesLocal.Isha` | string | required | Isha local 24h time HH:mm |\r\n\r\n### get_next_prayer\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `city` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `userId` | string | optional | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `latitude` | number | optional | Optional explicit latitude override |\r\n| `longitude` | number | optional | Optional explicit longitude override |\r\n| `timezone` | string | optional | IANA timezone; required in the same request when latitude/longitude are supplied. Must agree with the city or be compatible with the coordinate timezone lookup. |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Optional calculation authority override (auto-resolved from location by default) |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Optional Asr shadow jurisprudence override (Shafi or Hanafi) |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `currentLocalDate` | string | required | Current local date YYYY-MM-DD |\r\n| `timezone` | string | required | Resolved IANA timezone |\r\n| `nextPrayer` | string | required | Name of the upcoming prayer |\r\n| `nextPrayerAtUtc` | string | required | UTC timestamp of the upcoming prayer |\r\n| `nextPrayerLocalTime` | string | required | Formatted local time HH:mm |\r\n| `remainingMinutes` | integer | required | Minutes remaining until prayer start |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | Active calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | required | Active Asr jurisprudence |\r\n| `authorityDescription` | string | optional |  |\r\n| `selectionReason` | string | optional |  |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `authorityNotice` | object | optional |  |\r\n| `authorityNotice.method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `authorityNotice.madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityNotice.authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `authorityNotice.selectionReason` | string | required | Rationale for selecting this authority |\r\n| `authorityNotice.requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `authorityNotice.highLatitudeAdjustment` | object | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `authorityNotice.highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `authorityNotice.highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `authorityNotice.highLatitudeAdjustment.explanation` | string | required |  |\r\n| `authorityNotice.calculationDetails` | object | optional |  |\r\n| `authorityNotice.calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `authorityNotice.calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `authorityNotice.calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `authorityNotice.calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `authorityNotice.calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `authorityNotice.calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `authorityNotice.calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `authorityNotice.calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n\r\n### configure_prayer_preferences\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `clearFixedLocation` | boolean | optional | Remove stored fixedCity, fixedCoordinates and timezone. Switches to auto_travel unless locationMode is supplied. Cannot combine with a new fixed location/timezone. |\r\n| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n| `locationMode` | `auto_travel`, `fixed` | optional | Location strategy: fixed uses saved location; auto_travel requires the caller to supply current city or coordinates/timezone on each query and never uses IP geolocation. |\r\n| `fixedCity` | string | optional | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. |\r\n| `fixedCoordinates` | object | optional | Fixed geographical coordinates |\r\n| `fixedCoordinates.latitude` | number | required |  |\r\n| `fixedCoordinates.longitude` | number | required |  |\r\n| `timezone` | string | optional | IANA timezone identifier (e.g. Asia/Riyadh, Europe/London) |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional | Islamic prayer calculation authority |\r\n| `madhab` | `Shafi`, `Hanafi` | optional | Jurisprudential Asr shadow calculation: Shafi or Hanafi |\r\n| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional | High latitude twilight adjustment rule |\r\n| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional | Reminder display policy: prayer_window, exact_window, persistent |\r\n| `exactWindowMinutes` | integer | optional | Duration in minutes for exact_window mode. Omitted updates preserve the saved value; if unset, the service default is 20 minutes unless the operator overrides it. |\r\n| `locale` | `en`, `ar` | optional | Language for reminder text: en or ar |\r\n| `minuteAdjustments` | object | optional | Custom per-prayer minute offsets (-60 to +60). For fixed locations, combined settings must preserve timetable chronology for the current and next local day before saving; auto-travel offsets are validated when a query supplies its location. |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `enabled` | boolean | optional | Whether prayer reminders are enabled |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `success` | boolean | required | Whether configuration succeeded |\r\n| `preferences` | object | required |  |\r\n| `preferences.fixedCoordinatesConfigured` | boolean | required |  |\r\n| `preferences.fixedCityConfigured` | boolean | required |  |\r\n| `preferences.locationMode` | `auto_travel`, `fixed` | optional |  |\r\n| `preferences.fixedCity` | string | optional |  |\r\n| `preferences.timezone` | string | optional |  |\r\n| `preferences.calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |\r\n| `preferences.madhab` | `Shafi`, `Hanafi` | optional |  |\r\n| `preferences.highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |\r\n| `preferences.reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |\r\n| `preferences.exactWindowMinutes` | number | optional |  |\r\n| `preferences.locale` | `en`, `ar` | optional |  |\r\n| `preferences.minuteAdjustments` | object | optional |  |\r\n| `preferences.minuteAdjustments.fajr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.sunrise` | integer | optional |  |\r\n| `preferences.minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.asr` | integer | optional |  |\r\n| `preferences.minuteAdjustments.maghrib` | integer | optional |  |\r\n| `preferences.minuteAdjustments.isha` | integer | optional |  |\r\n| `preferences.enabled` | boolean | optional |  |\r\n| `preferences.updatedAtUtc` | string | optional |  |\r\n| `preferences.message` | string | optional |  |\r\n\r\n### get_prayer_preferences\r\n\r\nInput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `userId` | string | required | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. |\r\n\r\nOutput\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `fixedCoordinatesConfigured` | boolean | required |  |\r\n| `fixedCityConfigured` | boolean | required |  |\r\n| `locationMode` | `auto_travel`, `fixed` | optional |  |\r\n| `fixedCity` | string | optional |  |\r\n| `timezone` | string | optional |  |\r\n| `calculationMethod` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | optional |  |\r\n| `madhab` | `Shafi`, `Hanafi` | optional |  |\r\n| `highLatitudeRule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | optional |  |\r\n| `reminderMode` | `prayer_window`, `exact_window`, `persistent` | optional |  |\r\n| `exactWindowMinutes` | number | optional |  |\r\n| `locale` | `en`, `ar` | optional |  |\r\n| `minuteAdjustments` | object | optional |  |\r\n| `minuteAdjustments.fajr` | integer | optional |  |\r\n| `minuteAdjustments.sunrise` | integer | optional |  |\r\n| `minuteAdjustments.dhuhr` | integer | optional |  |\r\n| `minuteAdjustments.asr` | integer | optional |  |\r\n| `minuteAdjustments.maghrib` | integer | optional |  |\r\n| `minuteAdjustments.isha` | integer | optional |  |\r\n| `enabled` | boolean | optional |  |\r\n| `updatedAtUtc` | string | optional |  |\r\n| `message` | string | optional |  |\r\n\r\nThe `preferences` configuration result uses the same fields as `get_prayer_preferences`. Nested disclosure objects are defined below once for all prayer tools.\r\n\r\n## highLatitudeAdjustment\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `applied` | boolean | required |  |\r\n| `rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `astronomicalLatitudeClamped` | boolean | required |  |\r\n| `effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `explanation` | string | required |  |\r\n\r\n## calculationDetails\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `locationIsApproximate` | boolean | optional |  |\r\n| `fallbackLocationUsed` | boolean | optional |  |\r\n| `methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `regionalMinuteAdjustments` | object | optional |  |\r\n| `regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `customMinuteAdjustments` | object | optional |  |\r\n| `customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `customMinuteAdjustments.asr` | integer | optional |  |\r\n| `customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `customMinuteAdjustments.isha` | integer | optional |  |\r\n| `methodMinuteAdjustments` | object | optional |  |\r\n| `methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `appliedMinuteAdjustments` | object | optional |  |\r\n| `calendarAlignmentAdjusted` | boolean | optional |  |\r\n\r\n## authorityNotice\r\n\r\n| Field | Type / allowed values | Presence | Description |\r\n| --- | --- | --- | --- |\r\n| `method` | `UmmAlQura`, `MuslimWorldLeague`, `Egyptian`, `Karachi`, `NorthAmerica`, `Dubai`, `Qatar`, `Kuwait`, `MoonsightingCommittee`, `Singapore`, `Turkey`, `Tehran` | required | The calculation authority method |\r\n| `madhab` | `Shafi`, `Hanafi` | required | The Asr jurisprudence school |\r\n| `authorityDescription` | string | required | Full descriptive name of the calculation authority |\r\n| `selectionReason` | string | required | Rationale for selecting this authority |\r\n| `requiredDisplayInstruction` | string | required | Mandatory theological notice for AI presentation |\r\n| `highLatitudeAdjustment` | object | optional |  |\r\n| `highLatitudeAdjustment.applied` | boolean | required |  |\r\n| `highLatitudeAdjustment.rule` | `MiddleOfTheNight`, `SeventhOfTheNight`, `TwilightAngle` | required |  |\r\n| `highLatitudeAdjustment.methodSpecificTwilightRule` | `MoonsightingCommittee` | optional |  |\r\n| `highLatitudeAdjustment.astronomicalLatitudeClamped` | boolean | required |  |\r\n| `highLatitudeAdjustment.effectiveLatitude` | `48` or `-48` | optional | Substitute latitude only; never the user coordinate |\r\n| `highLatitudeAdjustment.adjustedPrayers` | array of `Fajr`, `Sunrise`, `Dhuhr`, `Asr`, `Maghrib`, `Isha` | required |  |\r\n| `highLatitudeAdjustment.explanation` | string | required |  |\r\n| `calculationDetails` | object | optional |  |\r\n| `calculationDetails.expectedTimezone` | string | optional | Timezone from city registry or approximate coordinate lookup |\r\n| `calculationDetails.timezoneValidation` | `coordinate_lookup`, `nearby_boundary`, `city_registry`, `polar_choice`, `ocean_choice` | optional | Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure |\r\n| `calculationDetails.timezoneSource` | `explicit_override`, `stored_preference`, `city_default`, `host_header` | optional | Source of the validated timezone or disclosed ocean/pole choice |\r\n| `calculationDetails.locationBasis` | `explicit_coordinates`, `explicit_city`, `stored_fixed_coordinates`, `stored_fixed_city`, `host_coordinates`, `host_city`, `network_geolocation`, `default_location` | optional |  |\r\n| `calculationDetails.locationIsApproximate` | boolean | optional |  |\r\n| `calculationDetails.fallbackLocationUsed` | boolean | optional |  |\r\n| `calculationDetails.methodSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.madhabSource` | `explicit_override`, `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.highLatitudeRuleSource` | `stored_preference`, `geographic_default` | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.regionalMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.customMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.fajr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.sunrise` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.dhuhr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.asr` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.maghrib` | integer | optional |  |\r\n| `calculationDetails.methodMinuteAdjustments.isha` | integer | optional |  |\r\n| `calculationDetails.appliedMinuteAdjustments` | object | optional |  |\r\n| `calculationDetails.calendarAlignmentAdjusted` | boolean | optional |  |\r\n"
}

SHA-256 of public snapshot: e4b200d6bcb3fcdb97e66f0b21cd6c685c52897ea2ab85c3a3dead9e1354a446