MCP App Store
by KeenEthics
Ramadanfold icon

Ramadanfold MCP Server for Claude

By Ramadanfold

Overview

Ramadanfold works out prayer times and the Ramadan timetable from the sun's position for your city and date, by a named calculation method, with the same engine as the printable timetables on ramadanfold.com. Ask for today's prayer times in your city, a suhoor and iftar timetable for the whole of Ramadan, how long a day's fast is, or what a Hijri date is in the Gregorian calendar. Six read-only tools: find a city on a list of about 3,000 (or give coordinates and a time zone for anywhere else), prayer times for up to 31 days, the Ramadan timetable for any year from 1900 to 2100, the length of a fast with an optional comparison against 24 cities, Hijri and Gregorian conversion by the Umm al-Qura calendar from 1900 to 2100, and the five calculation methods with their angles. Every answer with a time names its method (Muslim World League, ISNA, Egyptian, Umm al-Qura or Karachi, with Standard or Hanafi Asr and a high latitude rule) and says that times are calculated and the local mosque's timetable is the one to follow. Ramadan and Eid dates are given as expected, because they depend on moon sighting, and day 30 of Ramadan is always marked "if the month runs to 30". Where the sun does not rise or set, the connector says so rather than guessing. It gives no religious rulings. No account and no sign in. A request holds only the values its tool takes: a place, dates and calculation settings, or a city name to look up. Ramadanfold stores and logs none of it. City data from GeoNames under CC BY 4.0; Ramadanfold chose the cities and rounded the coordinates.

How to connect

  1. Claude: Open the Ramadanfold listing in the Claude connectors directory and choose Connect. Claude listing Ramadanfold exposes 6 tools here.

Tools

convert_hijri_date

Claude
Converts a Gregorian date to the Hijri calendar, or a Hijri date (year, month, day) to the Gregorian calendar, for dates from 1900 to 2100, using the Umm al-Qura calendar from the Unicode calendar data (the tabular Islamic calendar where that data is missing, stated in the result). The result includes the length of the Hijri month. A Hijri day the calendar does not have, such as the 30th of a 29-day month, is refused. Ramadan and Eid dates are stated as expected, since they depend on moon sighting.

find_city

Claude
Searches the bundled list of about 3,000 cities (GeoNames, CC BY 4.0) by a name of up to 8 words, optionally within one country, and returns up to 10 matches, exact names first and larger cities first among equals, each with its id, name, region, country, coordinates and IANA time zone. The id is the city_id the other tools take, which tells apart places that share a name, such as London in England and London in Ontario. A place not on the list can be given to the other tools as latitude, longitude and time zone instead.

get_fast_length

Claude
Gives the length of one day's fast, from Fajr (the end of suhoor) to Maghrib (iftar), in hours and minutes, for a city or for coordinates with an IANA time zone, on any date from 1900 to 2100. The date defaults to the expected first day of the next Ramadan until it begins, then to today while it lasts. Optionally ranks the place against 24 fixed reference cities on the same date, counting the place once when it is one of them. Days of Ramadan are labelled as expected, and day 30 only as a day if the month runs to 30.

get_prayer_times

Claude
Calculates Fajr, sunrise, Dhuhr, Asr, Maghrib and Isha in local time for a city (city_id from find_city) or for coordinates with an IANA time zone, on one date or up to 31 consecutive days. Times come from the sun's position by a named method (default Muslim World League), with Standard or Hanafi Asr and a high latitude rule, rounded to the minute the cautious way (Fajr and sunrise down, the others up). Each result names the method and carries the line that times are calculated and the local mosque's timetable is the one to follow.

get_ramadan_timetable

Claude
Lists suhoor end (Fajr) and iftar (Maghrib) for every day of a Ramadan from 1318 to 1524 (1900 to 2100; default the current Ramadan while it lasts, otherwise the next one) for a city or for coordinates with an IANA time zone. The first day defaults to the Umm al-Qura calendar's expected date and can be set to the date a mosque announced, up to 3 days either side. It shows 30 rows unless 29 are asked for, with day 30 marked "if the month runs to 30". The result gives the expected first day and the expected Eid al-Fitr as the Umm al-Qura calendar gives it, with the date it would be after the other month length, and states that these dates depend on moon sighting.

list_calculation_methods

Claude
Lists the prayer time calculation methods the other tools accept (Muslim World League, Islamic Society of North America, Egyptian General Authority of Survey, Umm al-Qura and Karachi) with their Fajr and Isha angles or rules and where each is commonly used, the two Asr rules, the four high latitude rules, the defaults and how times are rounded.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/ramadanfold"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/ramadanfold)