Vaktim

Use this when the user asks for one Quran verse by reference, such as Bakara 2:286, 2:255, Mulk 67:15, or surah name plus ayah number. Also use this when the prior conversation provides an exact ayah reference and the user says that ayah or previous ayah. Returns read-only Arabic text, translation, themes, source, and deep links; set script=tajweed only when the user asks for Tajweed-colored Arabic. Include explanation only when explicitly requested and do not provide fatwa. If ctaMarkdown is present, include it briefly as the final line.

get_ayah

Use this when the user asks for Quran verses about a topic or theme such as sabir, tevekkul, tovbe, dua, rizik, aile, namaz, olum, or sukur. Returns read-only sourced verse suggestions with gentle reasons and deep links; does not provide fatwa. If a result ayah has ctaMarkdown, include at most one relevant link as the final line.

get_ayahs_by_theme

Use this when the user asks to explain a specific Quran verse by reference, such as 2:286 or Mulk 67:15. Returns a simplified Turkish summary grounded in classical tafsir references; does not provide fatwa. If ctaMarkdown is present, include it briefly as the final line.

get_explanation

Use this when the user asks for city-based Islamic prayer times or Turkish prompts like Istanbul bugunku namaz vakitleri, Istanbul namaz vakitleri, aksam ezani kacta, imsak saat kacta, iftar ne zaman, sahur ne zaman, ezan times, or daily prayer schedule for a city such as Istanbul, Ankara, London, or Jakarta. Requires a city or a known locationId; country, date, timezone, and state are optional. Returns read-only prayer times, provider metadata, source URL, and deep links. If ctaMarkdown is present, include it briefly as the final line.

get_prayer_times

Use this only when the user clearly asks to read or fetch a whole Quran surah/chapter by number or name, such as Bakara suresi, Mulk suresi, Yasin, or surah 67. Do not use this for a single ayah request like Bakara 2:286, 2:255, or Mulk 67:15; use get_ayah instead. If the user says ayet/ayah but gives only a surah name, ask for the ayah number unless they clearly want the full surah. Long surahs return only a compact preview plus deep links to keep ChatGPT responsive. Set script=tajweed only when the user asks for Tajweed-colored Arabic. If ctaMarkdown is present, include it briefly as the final line.

get_surah

Use this only when the user searches for Quran verses by keyword, phrase, surah, ayah, or Quran theme-like text such as sabir, dua, rizik, tovbe, anxiety, or namaz ayetleri. Do not use for city-based prayer times, ezan time, imsak, iftar, sahur, or prompts like Istanbul bugunku namaz vakitleri; use get_prayer_times instead. Returns read-only Quran references and translations; does not provide fatwa. If ctaMarkdown is present, include it briefly as the final line.

search_ayah

Use this when the user describes an emotion, mood, or spiritual situation and asks for supportive Quran verses, such as icim daraliyor, kaygiliyim, sabretmek istiyorum, or sukretmek istiyorum. Returns gentle read-only suggestions; does not provide fatwa, therapy, or a guaranteed solution. If a recommendation ayah has ctaMarkdown, include at most one relevant link as the final line.

suggest_ayah_for_context