Server definition
- Hash
- sha256:7917663caa6cfe3e7811ea161c0ba11160b39bfdd78be338a3c42e7275ae2b02
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": "MANDATORY TRANSPARENCY INSTRUCTION FOR AI MODELS: When answering user queries regarding prayer times, timetable schedules, next prayer countdowns, or prayer status, you MUST ALWAYS explicitly inform the user of: 1) The exact calculation authority method used (e.g. Palestinian Ministry of Awqaf / Egyptian Survey Authority, Umm al-Qura University, Diyanet, Karachi, ISNA, etc.). 2) The exact reason WHY this authority was chosen (e.g. automatically resolved from geographic location or explicit user preference). Never present prayer times without disclosing the authority and reason. Also disclose highLatitudeAdjustment.explanation whenever applied, including substituted polar sunrise/sunset. Require explicit user city or coordinates/timezone; on location_required ask for location and never guess from infrastructure IP.",
"tools": [
{
"description": "Updates persistent prayer preferences, overwriting supplied settings while preserving omitted settings. Setting fixedCity replaces stored fixedCoordinates and stores the canonical city timezone; contradictory timezones are rejected; setting fixedCoordinates replaces stored fixedCity. Can disable reminders. Fixed mode requires a supported fixedCity or fixedCoordinates with timezone; new coordinates require timezone in the same request. clearFixedLocation removes saved location and timezone and defaults to auto_travel. Previous values are not retained for undo.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calculationMethod": {
"description": "Islamic prayer calculation authority",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"clearFixedLocation": {
"description": "Remove stored fixedCity, fixedCoordinates and timezone. Switches to auto_travel unless locationMode is supplied. Cannot combine with a new fixed location/timezone.",
"type": "boolean"
},
"enabled": {
"description": "Whether prayer reminders are enabled",
"type": "boolean"
},
"exactWindowMinutes": {
"description": "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.",
"maximum": 120,
"minimum": 5,
"type": "integer"
},
"fixedCity": {
"description": "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.",
"type": "string"
},
"fixedCoordinates": {
"description": "Fixed geographical coordinates",
"properties": {
"latitude": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"maximum": 180,
"minimum": -180,
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"highLatitudeRule": {
"description": "High latitude twilight adjustment rule",
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
},
"locale": {
"description": "Language for reminder text: en or ar",
"enum": [
"en",
"ar"
],
"type": "string"
},
"locationMode": {
"description": "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.",
"enum": [
"auto_travel",
"fixed"
],
"type": "string"
},
"madhab": {
"description": "Jurisprudential Asr shadow calculation: Shafi or Hanafi",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"minuteAdjustments": {
"description": "Custom per-prayer minute offsets (-60 to +60)",
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"reminderMode": {
"description": "Reminder display policy: prayer_window, exact_window, persistent",
"enum": [
"prayer_window",
"exact_window",
"persistent"
],
"type": "string"
},
"timezone": {
"description": "IANA timezone identifier (e.g. Asia/Riyadh, Europe/London)",
"type": "string"
},
"userId": {
"description": "Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.",
"maxLength": 256,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
},
"name": "configure_prayer_preferences",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"preferences": {
"additionalProperties": false,
"properties": {
"calculationMethod": {
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"enabled": {
"type": "boolean"
},
"exactWindowMinutes": {
"type": "number"
},
"fixedCity": {
"type": "string"
},
"fixedCityConfigured": {
"type": "boolean"
},
"fixedCoordinatesConfigured": {
"type": "boolean"
},
"highLatitudeRule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
},
"locale": {
"enum": [
"en",
"ar"
],
"type": "string"
},
"locationMode": {
"enum": [
"auto_travel",
"fixed"
],
"type": "string"
},
"madhab": {
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"message": {
"type": "string"
},
"minuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"reminderMode": {
"enum": [
"prayer_window",
"exact_window",
"persistent"
],
"type": "string"
},
"timezone": {
"type": "string"
},
"updatedAtUtc": {
"type": "string"
}
},
"required": [
"fixedCoordinatesConfigured",
"fixedCityConfigured"
],
"type": "object"
},
"success": {
"description": "Whether configuration succeeded",
"type": "boolean"
}
},
"required": [
"success",
"preferences"
],
"type": "object"
}
},
{
"description": "Returns the immediate next prayer name, scheduled time, authority calculation method, and remaining countdown in minutes. MANDATORY: The LLM must always explicitly disclose to the user which calculation authority method was used and why it was selected (see authorityNotice in response).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"allOf": [
{
"not": {
"required": [
"city",
"latitude"
]
}
},
{
"not": {
"required": [
"city",
"longitude"
]
}
}
],
"dependentRequired": {
"latitude": [
"longitude",
"timezone"
],
"longitude": [
"latitude",
"timezone"
]
},
"properties": {
"calculationMethod": {
"description": "Optional calculation authority override (auto-resolved from location by default)",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"city": {
"description": "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.",
"type": "string"
},
"latitude": {
"description": "Optional explicit latitude override",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional explicit longitude override",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"madhab": {
"description": "Optional Asr shadow jurisprudence override (Shafi or Hanafi)",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"timezone": {
"description": "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.",
"type": "string"
},
"userId": {
"description": "Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.",
"maxLength": 256,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"type": "object"
},
"name": "get_next_prayer",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"authorityDescription": {
"type": "string"
},
"authorityNotice": {
"additionalProperties": false,
"properties": {
"authorityDescription": {
"description": "Full descriptive name of the calculation authority",
"type": "string"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"madhab": {
"description": "The Asr jurisprudence school",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"method": {
"description": "The calculation authority method",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"requiredDisplayInstruction": {
"description": "Mandatory theological notice for AI presentation",
"type": "string"
},
"selectionReason": {
"description": "Rationale for selecting this authority",
"type": "string"
}
},
"required": [
"method",
"madhab",
"authorityDescription",
"selectionReason",
"requiredDisplayInstruction"
],
"type": "object"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"calculationMethod": {
"description": "Active calculation authority",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"currentLocalDate": {
"description": "Current local date YYYY-MM-DD",
"type": "string"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"madhab": {
"description": "Active Asr jurisprudence",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"minuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"nextPrayer": {
"description": "Name of the upcoming prayer",
"type": "string"
},
"nextPrayerAtUtc": {
"description": "UTC timestamp of the upcoming prayer",
"type": "string"
},
"nextPrayerLocalTime": {
"description": "Formatted local time HH:mm",
"type": "string"
},
"remainingMinutes": {
"description": "Minutes remaining until prayer start",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"selectionReason": {
"type": "string"
},
"timezone": {
"description": "Resolved IANA timezone",
"type": "string"
}
},
"required": [
"currentLocalDate",
"timezone",
"nextPrayer",
"nextPrayerAtUtc",
"nextPrayerLocalTime",
"remainingMinutes",
"calculationMethod",
"madhab"
],
"type": "object"
}
},
{
"description": "Returns the currently active calculation settings and preferences for a user. Read-only operation.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"userId": {
"description": "Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.",
"maxLength": 256,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"required": [
"userId"
],
"type": "object"
},
"name": "get_prayer_preferences",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"calculationMethod": {
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"enabled": {
"type": "boolean"
},
"exactWindowMinutes": {
"type": "number"
},
"fixedCity": {
"type": "string"
},
"fixedCityConfigured": {
"type": "boolean"
},
"fixedCoordinatesConfigured": {
"type": "boolean"
},
"highLatitudeRule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
},
"locale": {
"enum": [
"en",
"ar"
],
"type": "string"
},
"locationMode": {
"enum": [
"auto_travel",
"fixed"
],
"type": "string"
},
"madhab": {
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"message": {
"type": "string"
},
"minuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"reminderMode": {
"enum": [
"prayer_window",
"exact_window",
"persistent"
],
"type": "string"
},
"timezone": {
"type": "string"
},
"updatedAtUtc": {
"type": "string"
}
},
"required": [
"fixedCoordinatesConfigured",
"fixedCityConfigured"
],
"type": "object"
}
},
{
"description": "Checks if a Muslim obligatory prayer (Fajr, Dhuhr, Asr, Maghrib, Isha) is currently due for the user location and returns active reminder details. MANDATORY: The LLM must always explicitly disclose to the user which calculation authority method was used and why it was selected (see authorityNotice in response).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"allOf": [
{
"not": {
"required": [
"city",
"latitude"
]
}
},
{
"not": {
"required": [
"city",
"longitude"
]
}
}
],
"dependentRequired": {
"latitude": [
"longitude",
"timezone"
],
"longitude": [
"latitude",
"timezone"
]
},
"properties": {
"calculationMethod": {
"description": "Optional calculation authority override (auto-resolved from location by default)",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"city": {
"description": "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.",
"type": "string"
},
"latitude": {
"description": "Optional explicit latitude override",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional explicit longitude override",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"madhab": {
"description": "Optional Asr shadow jurisprudence override (Shafi or Hanafi)",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"timezone": {
"description": "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.",
"type": "string"
},
"userId": {
"description": "Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.",
"maxLength": 256,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"type": "object"
},
"name": "get_prayer_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"authorityDescription": {
"description": "Description of the calculation authority",
"type": "string"
},
"authorityNotice": {
"additionalProperties": false,
"description": "Mandatory theological transparency notice",
"properties": {
"authorityDescription": {
"description": "Full descriptive name of the calculation authority",
"type": "string"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"madhab": {
"description": "The Asr jurisprudence school",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"method": {
"description": "The calculation authority method",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"requiredDisplayInstruction": {
"description": "Mandatory theological notice for AI presentation",
"type": "string"
},
"selectionReason": {
"description": "Rationale for selecting this authority",
"type": "string"
}
},
"required": [
"method",
"madhab",
"authorityDescription",
"selectionReason",
"requiredDisplayInstruction"
],
"type": "object"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"calculationMethod": {
"description": "Active calculation authority",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"expiresAtUtc": {
"description": "UTC expiration time of the active prayer window",
"type": "string"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"localDate": {
"description": "Current local date in YYYY-MM-DD",
"type": "string"
},
"madhab": {
"description": "Active Asr jurisprudence",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"minuteAdjustments": {
"additionalProperties": false,
"description": "Applied minute adjustments",
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"nextPrayer": {
"description": "The name of the next upcoming prayer",
"type": "string"
},
"nextPrayerAtUtc": {
"description": "UTC timestamp of the next upcoming prayer",
"type": "string"
},
"nextPrayerCalculation": {
"additionalProperties": false,
"description": "Adjustment disclosure for the actual schedule of the next event, including tomorrow",
"properties": {
"authorityNotice": {
"additionalProperties": false,
"properties": {
"authorityDescription": {
"description": "Full descriptive name of the calculation authority",
"type": "string"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"madhab": {
"description": "The Asr jurisprudence school",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"method": {
"description": "The calculation authority method",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"requiredDisplayInstruction": {
"description": "Mandatory theological notice for AI presentation",
"type": "string"
},
"selectionReason": {
"description": "Rationale for selecting this authority",
"type": "string"
}
},
"required": [
"method",
"madhab",
"authorityDescription",
"selectionReason",
"requiredDisplayInstruction"
],
"type": "object"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"localDate": {
"type": "string"
}
},
"required": [
"localDate"
],
"type": "object"
},
"prayer": {
"description": "The name of the currently due prayer if applicable",
"type": "string"
},
"prayerWindowExpiresAtUtc": {
"description": "End of the active prayer period; same boundary as legacy expiresAtUtc",
"type": "string"
},
"reminderDue": {
"description": "Whether a prayer is currently due for reminder",
"type": "boolean"
},
"reminderText": {
"description": "Localized reminder message",
"type": "string"
},
"reminderWindowExpiresAtUtc": {
"description": "Reminder eligibility end; exact_window is capped by the prayer period boundary. Fields appear when a reminder is emitted.",
"type": "string"
},
"selectionReason": {
"description": "Reason for authority selection",
"type": "string"
},
"startedAtUtc": {
"description": "UTC start time of the active prayer window",
"type": "string"
},
"timezone": {
"description": "Resolved IANA timezone",
"type": "string"
}
},
"required": [
"reminderDue",
"localDate",
"nextPrayer",
"nextPrayerAtUtc",
"timezone",
"calculationMethod",
"madhab"
],
"type": "object"
}
},
{
"description": "Retrieves today prayer timetable (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha) in UTC and formatted local time. MANDATORY: The LLM must always explicitly disclose to the user which calculation authority method was used and why it was selected (see authorityNotice in response).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"allOf": [
{
"not": {
"required": [
"city",
"latitude"
]
}
},
{
"not": {
"required": [
"city",
"longitude"
]
}
}
],
"dependentRequired": {
"latitude": [
"longitude",
"timezone"
],
"longitude": [
"latitude",
"timezone"
]
},
"properties": {
"calculationMethod": {
"description": "Optional calculation authority override (auto-resolved from location by default)",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"city": {
"description": "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.",
"type": "string"
},
"date": {
"description": "Date in YYYY-MM-DD format (defaults to today)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"latitude": {
"description": "Optional explicit latitude override",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional explicit longitude override",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"madhab": {
"description": "Optional Asr shadow jurisprudence override (Shafi or Hanafi)",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"timezone": {
"description": "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.",
"type": "string"
},
"userId": {
"description": "Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.",
"maxLength": 256,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"type": "object"
},
"name": "get_today_prayer_times",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"authorityDescription": {
"type": "string"
},
"authorityNotice": {
"additionalProperties": false,
"properties": {
"authorityDescription": {
"description": "Full descriptive name of the calculation authority",
"type": "string"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"madhab": {
"description": "The Asr jurisprudence school",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"method": {
"description": "The calculation authority method",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"requiredDisplayInstruction": {
"description": "Mandatory theological notice for AI presentation",
"type": "string"
},
"selectionReason": {
"description": "Rationale for selecting this authority",
"type": "string"
}
},
"required": [
"method",
"madhab",
"authorityDescription",
"selectionReason",
"requiredDisplayInstruction"
],
"type": "object"
},
"calculationDetails": {
"additionalProperties": false,
"properties": {
"appliedMinuteAdjustments": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"calendarAlignmentAdjusted": {
"type": "boolean"
},
"customMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"expectedTimezone": {
"description": "Timezone from city registry or approximate coordinate lookup",
"type": "string"
},
"fallbackLocationUsed": {
"type": "boolean"
},
"highLatitudeRuleSource": {
"enum": [
"stored_preference",
"geographic_default"
],
"type": "string"
},
"locationBasis": {
"enum": [
"explicit_coordinates",
"explicit_city",
"stored_fixed_coordinates",
"stored_fixed_city",
"host_coordinates",
"host_city",
"network_geolocation",
"default_location"
],
"type": "string"
},
"locationIsApproximate": {
"type": "boolean"
},
"madhabSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"methodMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"methodSource": {
"enum": [
"explicit_override",
"stored_preference",
"geographic_default"
],
"type": "string"
},
"regionalMinuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"timezoneSource": {
"description": "Source of the validated timezone or disclosed ocean/pole choice",
"enum": [
"explicit_override",
"stored_preference",
"city_default",
"host_header"
],
"type": "string"
},
"timezoneValidation": {
"description": "Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure",
"enum": [
"coordinate_lookup",
"nearby_boundary",
"city_registry",
"polar_choice",
"ocean_choice"
],
"type": "string"
}
},
"type": "object"
},
"calculationMethod": {
"description": "Active calculation authority",
"enum": [
"UmmAlQura",
"MuslimWorldLeague",
"Egyptian",
"Karachi",
"NorthAmerica",
"Dubai",
"Qatar",
"Kuwait",
"MoonsightingCommittee",
"Singapore",
"Turkey",
"Tehran"
],
"type": "string"
},
"highLatitudeAdjustment": {
"additionalProperties": false,
"properties": {
"adjustedPrayers": {
"items": {
"enum": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "string"
},
"type": "array"
},
"applied": {
"type": "boolean"
},
"astronomicalLatitudeClamped": {
"type": "boolean"
},
"effectiveLatitude": {
"anyOf": [
{
"const": 48,
"type": "number"
},
{
"const": -48,
"type": "number"
}
],
"description": "Substitute latitude only; never the user coordinate"
},
"explanation": {
"type": "string"
},
"methodSpecificTwilightRule": {
"const": "MoonsightingCommittee",
"type": "string"
},
"rule": {
"enum": [
"MiddleOfTheNight",
"SeventhOfTheNight",
"TwilightAngle"
],
"type": "string"
}
},
"required": [
"applied",
"rule",
"astronomicalLatitudeClamped",
"adjustedPrayers",
"explanation"
],
"type": "object"
},
"localDate": {
"description": "Local schedule date YYYY-MM-DD",
"type": "string"
},
"madhab": {
"description": "Active Asr jurisprudence",
"enum": [
"Shafi",
"Hanafi"
],
"type": "string"
},
"minuteAdjustments": {
"additionalProperties": false,
"properties": {
"asr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"dhuhr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"fajr": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"isha": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"maghrib": {
"maximum": 60,
"minimum": -60,
"type": "integer"
},
"sunrise": {
"maximum": 60,
"minimum": -60,
"type": "integer"
}
},
"type": "object"
},
"selectionReason": {
"type": "string"
},
"timesLocal": {
"additionalProperties": false,
"properties": {
"Asr": {
"description": "Asr local 24h time HH:mm",
"type": "string"
},
"Dhuhr": {
"description": "Dhuhr local 24h time HH:mm",
"type": "string"
},
"Fajr": {
"description": "Fajr local 24h time HH:mm",
"type": "string"
},
"Isha": {
"description": "Isha local 24h time HH:mm",
"type": "string"
},
"Maghrib": {
"description": "Maghrib local 24h time HH:mm",
"type": "string"
},
"Sunrise": {
"description": "Sunrise local 24h time HH:mm",
"type": "string"
}
},
"required": [
"Fajr",
"Sunrise",
"Dhuhr",
"Asr",
"Maghrib",
"Isha"
],
"type": "object"
},
"timesUtc": {
"additionalProperties": false,
"properties": {
"asr": {
"description": "Asr UTC timestamp",
"type": "string"
},
"dhuhr": {
"description": "Dhuhr UTC timestamp",
"type": "string"
},
"fajr": {
"description": "Fajr UTC timestamp",
"type": "string"
},
"isha": {
"description": "Isha UTC timestamp",
"type": "string"
},
"maghrib": {
"description": "Maghrib UTC timestamp",
"type": "string"
},
"sunrise": {
"description": "Sunrise UTC timestamp",
"type": "string"
}
},
"required": [
"fajr",
"sunrise",
"dhuhr",
"asr",
"maghrib",
"isha"
],
"type": "object"
},
"timezone": {
"description": "Resolved IANA timezone",
"type": "string"
}
},
"required": [
"localDate",
"timezone",
"calculationMethod",
"madhab",
"timesUtc",
"timesLocal"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7917663caa6cfe3e7811ea161c0ba11160b39bfdd78be338a3c42e7275ae2b02 | sha256sum