What it does

When you ask Claude about prayer times or Ramadan and the connector is on, Claude can call its tools and answer with figures worked out the way the times on this site are worked out: the sun's position for your city and date, a named calculation method, and cautious rounding, so suhoor never ends later, or iftar starts earlier, than the calculation.

Every answer with a time names the method it used and carries the line Ramadanfold prints on every timetable. Every Ramadan or Eid date is given as expected, because the start and the end of the month depend on moon sighting.

The address

https://mcp.ramadanfold.com/mcp

It is a remote MCP server over Streamable HTTP, with no sign in. It reads; it never writes, sends or changes anything.

How to add it in Claude

Ramadanfold is listed in Claude's connector directory, at claude.ai/directory/ramadanfold. Open that page while signed in to Claude to add it from there. The steps below add the same connector by its address instead.

For your own account, following Anthropic's steps for a custom connector (every Claude plan can add at least one):

  1. In Claude, go to Customize, then Connectors.
  2. Click “+ Add”, then “Add custom connector”.
  3. Enter a name, such as Ramadanfold. It is the name shown in the connectors list.
  4. Enter the address https://mcp.ramadanfold.com/mcp and click “Continue”.
  5. Check the authentication settings Claude found, then click “Continue”.
  6. Under “Authentication”, choose “No sign in”: there is nothing to sign in to. Leave the request headers empty.
  7. Click “Add”.

To use it in a chat, open the “+” button at the lower left, select Connectors and turn Ramadanfold on, then ask a question like the ones below.

On a Team or Enterprise plan, an Owner adds it for everyone first: Organization settings, then Connectors, “Add”, then “Custom” and “Web”, and the same steps from the name on. Members then find it under Customize, then Connectors, and click “Connect”. It can also be added from its directory listing.

The tools, in plain words

find_city
Finds a city on the bundled list of about 3,000 and gives its coordinates and time zone, so two places with one name are told apart.
get_prayer_times
Fajr, sunrise, Dhuhr, Asr, Maghrib and Isha for a city, or for coordinates with a time zone, on one day or up to 31 days in a row.
get_ramadan_timetable
Suhoor end and iftar for every day of a Ramadan from 1318 to 1524 (1900 to 2100), in 30 rows as on this site with day 30 marked, with the expected first day and the expected Eid, from the date the Umm al-Qura calendar gives or the date your mosque announced.
get_fast_length
How long one day's fast is, from Fajr to Maghrib, and if you ask, how it ranks against 24 cities from Reykjavik to Christchurch.
convert_hijri_date
A Gregorian date in the Hijri calendar, or a Hijri date in the Gregorian one, by the Umm al-Qura calendar, from 1900 to 2100.
list_calculation_methods
The five calculation methods with their angles and where each is used, the two Asr rules and the four high latitude rules.

The four tools whose answers carry notes, get_prayer_times, get_ramadan_timetable, get_fast_length and convert_hijri_date, take a detail setting. The full answer, the default, adds those notes, and for the three that give times, a link to the matching printable page on ramadanfold.com where there is one. The short answer keeps the figures, any warnings and the one line notes, and for times, the method's name.

Things to ask

What it does not do

Times are calculated; follow your local mosque for the start of the month and for prayer times.

Privacy in brief

A request holds the values its tool takes: a city id or coordinates with a time zone, the dates and the calculation settings, or for a city search, the name being looked for. Ramadanfold stores none of it and logs none of it. Cloudflare hosts the connector, under its own privacy policy. The full statement is in the privacy policy, under the Claude connector.

Where the data comes from

City names, coordinates and time zones come from GeoNames, used under the Creative Commons Attribution 4.0 licence; we chose the cities and rounded the coordinates. The expected first day of each Ramadan comes from the Umm al-Qura calendar as published in the Unicode calendar data. The sun's position follows Jean Meeus, Astronomical Algorithms. The expected first day of Ramadan 1448, for example, is 8 February 2027.

Support and security

Questions, and a time that does not match a rule stated here, go to [email protected]. Please send the city, the date, the method and the time you expected.

To report a security problem, write to the same address with what you found and how to see it, and allow time for a fix before telling others. The same contact is published at ramadanfold.com/.well-known/security.txt and mcp.ramadanfold.com/.well-known/security.txt.

Claude is a product of Anthropic. Ramadanfold is independent and is not affiliated with, or endorsed by, Anthropic.