Cite passages

Show where each passage comes from, with its book, author, printed page and link, and quote Qur’an verses and hadiths exactly as returned.

Every passage the MCP server or the API returns carries what a reader needs to find it in print. Show it wherever you use the text.

Cite each passage

A citation names the book, the author and the printed volume and page, and links to the page:

فيض القدير — عبد الرؤوف المناوي، ج 4، ص 233

Fayd al-Qadir — Abd al-Rauf al-Munawi, vol. 4, p. 233

title is that line, ready to show, in the language you asked for with locale.
url opens the printed page in the Turath reader, so a reader can check the text in its context. Link the citation to it.
book, author and pages hold the same details as separate fields, for your own format.

When a passage spans two pages, title and url name the first; pages lists them all.

Quote the text as returned

Show passage text as the API returns it, in Arabic, right to left. Don’t shorten a quotation without marking where text is left out.
If you translate a passage, say that the translation is yours or your app’s, and keep the Arabic beside it.
An AI app should quote passages rather than retell them, and should cite every passage it relies on.

Qur’an verses

GET /v1/quran/verses and the get_quran_verses tool return the Uthmani Arabic text of the verses. The Arabic text and the English translation come from the Quran Foundation API.

Cite verses by surah and verse, such as Qur’an 2:153, with the surah name.
Show the Arabic text with the translation, and present the translation as a translation.
Never alter, complete or paraphrase a verse. Show the text the response returns, in full.

Hadiths appear inside passages, in the wording of the book that quotes them. Quote that wording exactly and cite the passage it came from. Don’t complete a hadith from memory or join wording from different books.

What a citation shows

A citation shows where text came from. It doesn’t show that an answer built on it is correct, and a passage can be one scholar’s view among several. Say so in your app where readers might take an answer as a ruling.