Muslim Prayer Reminder MCP

Get Full Daily Prayer Timetable

get_today_prayer_times

Read-onlyIdempotent

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).

Input Schema

Name	Required	Description
`city`	No	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.
`date`	No	Date in YYYY-MM-DD format (defaults to today)
`madhab`	No	Optional Asr shadow jurisprudence override (Shafi or Hanafi)
`userId`	No	Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved.
`latitude`	No	Optional explicit latitude override
`timezone`	No	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.
`longitude`	No	Optional explicit longitude override
`calculationMethod`	No	Optional calculation authority override (auto-resolved from location by default)

Output Schema

Name	Required	Description
`madhab`	Yes	Active Asr jurisprudence
`timesUtc`	Yes
`timezone`	Yes	Resolved IANA timezone
`localDate`	Yes	Local schedule date YYYY-MM-DD
`timesLocal`	Yes
`authorityNotice`	No
`selectionReason`	No
`calculationMethod`	Yes	Active calculation authority
`minuteAdjustments`	No
`calculationDetails`	No
`authorityDescription`	No
`highLatitudeAdjustment`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 9, 2026

addedInput schema / dependencies

Added value: +{
+  "latitude": [
+    "longitude",
+    "timezone"
+  ],
+  "longitude": [
+    "latitude",
+    "timezone"
+  ]
+}

removedInput schema / dependentRequired

Removed value: -{
-  "latitude": [
-    "longitude",
-    "timezone"
-  ],
-  "longitude": [
-    "latitude",
-    "timezone"
-  ]
-}

changed

Output schema / properties / authorityNotice / properties / calculationDetails / properties / timezoneValidation / description

Previous value: -"Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure"New value: +"Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure"

changedOutput schema / properties / calculationDetails / properties / timezoneValidation / description

Previous value: -"Validation basis; ocean and mathematical-pole locations retain caller-selected civil timezone with explicit disclosure"New value: +"Validation basis; ocean locations require the matching nautical timezone or an adjacent coastal civil timezone; mathematical poles allow an explicit civil timezone with disclosure"

Changed10 schema fields changedOct 3, 2026

addedInput schema / allOf

Added value: +[
+  {
+    "not": {
+      "required": [
+        "city",
+        "latitude"
+      ]
+    }
+  },
+  {
+    "not": {
+      "required": [
+        "city",
+        "longitude"
+      ]
+    }
+  }
+]

addedInput schema / dependentRequired

Added value: +{
+  "latitude": [
+    "longitude",
+    "timezone"
+  ],
+  "longitude": [
+    "latitude",
+    "timezone"
+  ]
+}

changedInput schema / properties / timezone / description

Previous value: -"IANA timezone; required in the same request when latitude/longitude are supplied. Explicit overrides select the display timezone."New value: +"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."

addedInput schema / properties / userId / pattern
```
Added value: +"\\S"
```

addedOutput schema / properties / authorityNotice / properties / calculationDetails / properties / expectedTimezone

Added value: +{
+  "description": "Timezone from city registry or approximate coordinate lookup",
+  "type": "string"
+}

changed

Output schema / properties / authorityNotice / properties / calculationDetails / properties / timezoneSource / description

Previous value: -"Source of the display timezone; caller-selected overrides are not geographically validated."New value: +"Source of the validated timezone or disclosed ocean/pole choice"

addedOutput schema / properties / authorityNotice / properties / calculationDetails / properties / timezoneValidation

Added value: +{
+  "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"
+}

addedOutput schema / properties / calculationDetails / properties / expectedTimezone

Added value: +{
+  "description": "Timezone from city registry or approximate coordinate lookup",
+  "type": "string"
+}

changedOutput schema / properties / calculationDetails / properties / timezoneSource / description

Previous value: -"Source of the display timezone; caller-selected overrides are not geographically validated."New value: +"Source of the validated timezone or disclosed ocean/pole choice"

addedOutput schema / properties / calculationDetails / properties / timezoneValidation

Added value: +{
+  "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"
+}

Changed7 schema fields changedOct 3, 2026

changedInput schema / properties / city / description

Previous value: -"Supported predefined city. Supply city or coordinates with an IANA timezone; connector/IP geolocation is never used."New value: +"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."

addedInput schema / properties / date / pattern
```
Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
```

changedInput schema / properties / timezone / description

Previous value: -"Optional IANA timezone override"New value: +"IANA timezone; required in the same request when latitude/longitude are supplied. Explicit overrides select the display timezone."

changedInput schema / properties / userId / description

Previous value: -"Optional unique user identifier to load stored preferences. If omitted, pure geographic auto-resolution is applied."New value: +"Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved."

addedInput schema / properties / userId / maxLength
```
Added value: +256
```

addedOutput schema / properties / authorityNotice / properties / calculationDetails / properties / timezoneSource

Added value: +{
+  "description": "Source of the display timezone; caller-selected overrides are not geographically validated.",
+  "enum": [
+    "explicit_override",
+    "stored_preference",
+    "city_default",
+    "host_header"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / calculationDetails / properties / timezoneSource

Added value: +{
+  "description": "Source of the display timezone; caller-selected overrides are not geographically validated.",
+  "enum": [
+    "explicit_override",
+    "stored_preference",
+    "city_default",
+    "host_header"
+  ],
+  "type": "string"
+}

Changed5 schema fields changedOct 2, 2026

addedInput schema / properties / city

Added value: +{
+  "description": "Supported predefined city. Supply city or coordinates with an IANA timezone; connector/IP geolocation is never used.",
+  "type": "string"
+}

addedOutput schema / properties / authorityNotice / properties / calculationDetails

Added value: +{
+  "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"
+    },
+    "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"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / authorityNotice / properties / highLatitudeAdjustment

Added value: +{
+  "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"
+}

addedOutput schema / properties / calculationDetails

Added value: +{
+  "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"
+    },
+    "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"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / highLatitudeAdjustment

Added value: +{
+  "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"
+}

Changed2 schema fields changedOct 1, 2026
- removedInput schema / properties / date / pattern
```
Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"
```
- addedInput schema / properties / userId / minLength
```
Added value: +1
```

Changed1 schema field changedOct 1, 2026

addedInput schema / properties / userId

Added value: +{
+  "description": "Optional unique user identifier to load stored preferences. If omitted, pure geographic auto-resolution is applied.",
+  "type": "string"
+}

Changed3 schema fields changedSep 18, 2026

removedInput schema / properties / userId

Removed value: -{
-  "description": "Unique user or device ID",
-  "type": "string"
-}

removedOutput schema / properties / coordinates

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "latitude": {
-      "description": "Latitude in degrees",
-      "type": "number"
-    },
-    "longitude": {
-      "description": "Longitude in degrees",
-      "type": "number"
-    }
-  },
-  "required": [
-    "latitude",
-    "longitude"
-  ],
-  "type": "object"
-}

changedOutput schema / required

Previous value: -[
-  "localDate",
-  "timezone",
-  "coordinates",
-  "calculationMethod",
-  "madhab",
-  "timesUtc",
-  "timesLocal"
-]New value: +[
+  "localDate",
+  "timezone",
+  "calculationMethod",
+  "madhab",
+  "timesUtc",
+  "timesLocal"
+]

Changed1 schema field changedSep 6, 2026
- removedInput schema / additionalProperties
```
Removed value: -false
```
First observedSep 6, 2026

TDQS

A3.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds genuinely non-obvious behavioral context: the response carries an authorityNotice and the LLM is mandated to disclose the calculation method and its rationale to the user — a caller-side obligation not derivable from the annotations or schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tightly constructed sentences with the purpose front-loaded and zero filler. The second sentence is an operational mandate rather than a description, but it is short and clearly flagged with 'MANDATORY', so it earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value details need not be restated, and the description still flags the authorityNotice field. The one gap is location resolution: with zero required parameters, the description never explains what happens if no city or coordinates are supplied, which an agent needs to know before calling.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, including per-parameter docs, enum membership, city aliases, and the latitude/longitude/timezone dependency rules, so the schema carries the load. The description mentions only that location drives method auto-resolution and notes the authority override, adding no syntax or format detail beyond the schema; baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — retrieve today's prayer timetable — and enumerates the six prayers returned plus the UTC/local-time duality. It is distinguishable from siblings like get_next_prayer and get_prayer_status by the word 'timetable', but it never explicitly contrasts itself with them, so it falls short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: the agent can infer 'use me when the user wants the whole day's schedule' rather than a single next prayer. No alternatives are named, no conditions or exclusions are given, and the relationship to get_next_prayer / get_prayer_status is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Muslim Prayer Reminder MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.