UmmahAPI

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Islamic source data for assistants: Quran, hadith, tafsir, duas, prayer times and qibla. Answers come from real sources with citations instead of recalled text, so verses and hadith are not hallucinated. 36,000+ hadiths

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "UmmahAPI": {
      "url": "https://ummahapi.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• get_prayer_times

  Get Islamic prayer times (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha) for a location and date. Use this for any question about when a prayer is, or when Ramadan fasting starts or ends on a given day. Requires latitude and longitude.

  Parameters:

  • latitude (required) — number — Latitude, -90 to 90
  • longitude (required) — number — Longitude, -180 to 180
  • date — string — Date as YYYY-MM-DD. Defaults to today.
  • madhab — string — Asr calculation school. Hanafi gives the later Asr; the others share the standard Asr. Defaults to Shafi.
  • method — string — Calculation method, e.g. MuslimWorldLeague, UmmAlQura, Karachi, Egyptian, NorthAmerica. Defaults to MuslimWorldLeague.
  • timezone — string — IANA timezone, e.g. Asia/Karachi. Derived from coordinates if omitted.
  • highLatitudeRule — string — Rule for Fajr and Isha at high latitudes (roughly above 48 degrees north or south). Use recommended for usable summer times in places like London or Oslo.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_qibla

  Get the Qibla direction (compass bearing in degrees toward the Kaaba in Makkah) and the distance to Makkah from a location.

  Parameters:

  • latitude (required) — number — Latitude, -90 to 90
  • longitude (required) — number — Longitude, -180 to 180

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_quran_verse

  Get the exact text of a specific Quran verse by surah and ayah number, with Arabic, transliteration and translations. Use this whenever quoting the Quran so the wording and reference are accurate rather than recalled.

  Parameters:

  • surah (required) — integer — Surah number, 1 to 114
  • ayah (required) — integer — Ayah number within the surah
  • translation — string — Translation key: sahih_international, pickthall, yusuf_ali, urdu, turkish, indonesian, french, german, bengali, spanish, malay, bosnian. Defaults to sahih_international.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_quran

  Search the Quran by keyword or phrase and get matching verses with their references. Use this to find verses on a topic when the surah and ayah are not already known.

  Parameters:

  • query (required) — string — Search term, in English or Arabic
  • limit — integer — Max results, 1 to 25. Defaults to 10.
  • translation — string — Restrict search to one translation key. Searches all by default.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_tafsir

  Get classical tafsir (scholarly exegesis) for a specific Quran verse. Sources include Ibn Kathir, Maarif ul Quran and Tafsir Muyassar. Use this when asked what a verse means or how scholars explained it.

  Parameters:

  • surah (required) — integer — Surah number, 1 to 114
  • ayah (required) — integer — Ayah number within the surah
  • tafsir — string — Tafsir key. Call list_sources to see what is available. Defaults to the first available.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_hadith

  Search over 36,000 hadiths across ten collections by keyword. Returns the hadith text with its collection, number and grading where available. Use this before quoting any hadith, and to check whether a hadith someone mentions actually exists.

  Parameters:

  • query (required) — string — Search term
  • limit — integer — Max results, 1 to 25. Defaults to 10.
  • collection — string — Restrict to one collection, e.g. bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah. Searches all by default.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_hadith

  Get one specific hadith by its collection and number, with full text and grading.

  Parameters:

  • collection (required) — string — Collection slug, e.g. bukhari, muslim, tirmidhi
  • number (required) — integer — Hadith number within the collection

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_duas

  Search authentic duas (supplications) by keyword or situation, for example travel, anxiety, forgiveness, morning. Returns Arabic, transliteration, translation and the source reference.

  Parameters:

  • query (required) — string — Situation or keyword

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_sources

  List the hadith collections, tafsir sources, Quran translations and dua categories that are available. Call this when unsure what value to pass to another tool.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.