Quran

Quran — connector documentation

• MCP endpoint: https://quran.connectorbay.com/mcp
• REST API: POST https://quran.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://quran.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://quran.connectorbay.com/health · Tool schemas: https://quran.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/quran · agent@connectorbay.com

What Quran is for

An assistant asked "what does ayat al-kursi say" should not recite from memory — it should quote. Quran fetches the Arabic text and a named translation from alquran.cloud, word-by-word meanings and classical tafsir from quran.com, and hadith from the open hadith-api compilation of sunnah.com's collections, and returns them verbatim with references and links. Every answer says which translation, which tafsir, which edition, and which grader.

How references work

A verse can be asked for as 2:255, 2:255-257, Al-Baqarah 255, baqarah:255, Yasin 1-5, surah 18 ayah 10, or by a well-known name such as ayat al-kursi. Surahs match on number, Arabic name (with or without the article), the English name or its meaning ("The Cave"). Translations can be named by edition id (en.sahih), translator (pickthall, yusuf ali, jalandhry) or language code (ur, hi, bn, fr, es, id, tr — 45 languages), with a sensible default per language. Hadith are addressed by collection and the sunnah.com number, or by book/chapter; search downloads the whole collection once and keeps it warm.

What it is not

Quran does not interpret, summarise or rule. Translations differ and are labelled as the translator's; tafsir is the commentator's; gradings are the cited scholars'. For a ruling (fatwa) the answer points to a qualified scholar.

Tools

Qur'an

verse — A verse or range of verses: Arabic (Uthmani), the translation you ask for (Saheeh International by default; Urdu, Hindi, Bengali, French, Spanish, Indonesian, Turkish… by language code or translator name), transliteration on request, surah name and meaning, juz and page, sajda flag, and per-verse recitation MP3s. Up to 30 verses per call. Use for "what does 2:255 say", "Al-Kahf 1-10 in Urdu", "ayat al-kursi with transliteration". Args: ref, translation, extra_editions, reciter.

surah — A surah: its name, meaning, Meccan/Medinan, verse count and revelation order, a short introduction, and its verses in Arabic with the translation, paged 50 at a time. Use for "Surah Yasin", "read Al-Mulk in Urdu", "Al-Baqarah from verse 200". Args: surah, translation, from_verse, limit, with_intro.

surah_info — The full introduction to a surah — its name, period and circumstances of revelation, theme and structure (Maududi's Tafhim al-Qur'an introductions, via quran.com), with the surah's metadata. Use for "what is Surah Al-Kahf about", "when was Surah Al-Fath revealed". Args: surah, language.

surah_list — All 114 surahs: number, Arabic and English names, meaning, verse count, Meccan/Medinan, revelation order and page range. Use for "list the Medinan surahs", "which surah is number 67", "how many verses in Al-Baqarah". Args: revelation.

search_quran — Verses whose translation contains a word or phrase, with references and the matching text, across the whole Qur'an or one surah. Searches the translation (English by default; give 'ur', 'fr'… for others). Use for "verses about patience", "where is Maryam mentioned", "which verse says 'with hardship comes ease'". Args: query, translation, surah, limit.

tafsir — Classical and modern commentary on a verse: Ibn Kathir (abridged, English), Ma'ariful Qur'an, Tazkirul Qur'an; Ibn Kathir, Tabari, Qurtubi, Sa'di, Baghawi, Muyassar in Arabic; Ibn Kathir, Bayan-ul-Qur'an, Fi Zilal in Urdu; Ibn Kathir, Ahsanul Bayaan in Bengali. Tafsir often covers a group of verses; the covered range is returned. Use for "tafsir of 2:255", "what does Ibn Kathir say about Al-Kahf 10". Args: ref, tafsir, max_chars.

word_by_word — Each Arabic word of a verse with its transliteration and meaning, in order — for learning to read, memorising, or understanding a phrase. One verse per call. Use for "word by word of Al-Fatiha 1", "what does each word of 112:1 mean". Args: ref, language.

juz — The verses of a juz (para) in order with surah and verse references, Arabic and translation, paged. Use for "start of juz 30", "read juz Amma in Urdu", "which surahs are in juz 1". Args: number, translation, offset, limit.

recitation — Recitation audio: an MP3 link per verse (up to 50 per call) and, for the main reciters, the whole surah as one file. Use for "play Surah Mulk by Sudais", "recitation of ayat al-kursi", "Al-Fatiha audio by Husary". Args: ref, reciter.

translations — The available editions: 100+ translations in 45+ languages, Arabic text variants (Uthmani, simple, Indo-Pak, tajweed), transliterations and Arabic tafsirs — with the identifier to pass to other tools. Use for "which Urdu translations are there", "list translations in French". Args: language.

verse_of_the_day — One verse for today (the same verse for everyone on a given date, cycling through the whole Qur'an), in Arabic with the translation, transliteration and surah context. Use for "verse of the day", "give me an ayah to reflect on". Args: translation.

Hadith

hadith — One hadith by collection and number: text in the language asked (English by default), the Arabic, the book/chapter it sits in, gradings where the edition records them, and the sunnah.com link. Use for "Bukhari 1", "Sahih Muslim 2699", "the first hadith of Nawawi's 40". Args: collection, number, language, with_arabic.

hadith_book — Without a book number: the collection's table of contents (every book with its title and hadith range). With one: that book's hadiths in order, paged. Use for "what books are in Sahih Muslim", "Bukhari's Book of Revelation", "Tirmidhi's chapters on fasting". Args: collection, book, language, offset, limit.

search_hadith — Full-text search across a hadith collection (or all major ones): every hadith whose text contains all the words, with number, book, grading and link. Use for "hadith about intentions", "what did the Prophet say about neighbours", "hadith on seeking knowledge in Ibn Majah". Args: query, collection, language, limit.

hadith_collections — The ten collections available — Bukhari, Muslim, Abu Dawud, Tirmidhi, Nasa'i, Ibn Majah, Muwatta Malik, Nawawi's 40, 40 Hadith Qudsi, Dehlawi's 40 — with the languages each is available in and the key to use in other tools.

Names

names_of_allah — The 99 names of Allah (Asma ul-Husna): Arabic, transliteration and meaning — all of them, or the ones matching a name, meaning or number. Use for "what does Al-Wadud mean", "which names mean merciful", "the 99 names". Args: query.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/quran/support

Quran — Privacy Policy

Effective 22 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Quran is. Quran is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for the text of the Qur'an, its translations, word-by-word meanings, tafsir, recitation audio links, and the major hadith collections. You interact with your assistant; the assistant sends us only the specific request needed: a verse reference, a search word, a hadith number.

What we receive. The arguments of each tool call, the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

What we do not receive or store. We do not receive your conversation with the assistant, your name, contacts, or credentials for any service. Request arguments are used to fetch the answer in memory and are not stored; we keep no record of what anyone reads or searches. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Religious belief is sensitive; nothing here infers it. Use of this service says nothing about a person's beliefs and we do not treat it as if it did: no profile, no sharing, no sale, no training on it.

Sub-processors. To answer requests we send only the verse reference, search word or hadith number asked about (never anything about you) to alquran.cloud / Islamic Network, quran.com (Quran Foundation) and jsDelivr (which serves the open hadith-api files). Audio links point to Islamic Network's CDN; fetching them is between the listener and that CDN. Hosting: Vercel (United States regions).

Legal bases and your rights. For users in California, the EU/UK and elsewhere, our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days.

Children. Quran is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Contact. Unify Dynamics LLC · agent@connectorbay.com

Quran — Terms of Service

Effective 22 September 2026. These terms govern use of the Quran connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Quran returns the Arabic text of the Qur'an, translations, transliteration, word-by-word meanings, tafsir, chapter introductions, recitation audio links, and hadith from the major collections, from open sources. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Reference, not ruling. The Service reproduces texts; it does not interpret them, issue religious rulings, or represent any school or authority. Translations and tafsir are the work of the named translators and commentators; hadith gradings are the named scholars' opinions. Consult a qualified scholar for guidance.
3. Accuracy. Texts are reproduced as published by the sources named in each response. Report an error to agent@connectorbay.com and we will pass it to the source.
4. Acceptable use. Do not use the Service to overwhelm the underlying services or to circumvent rate limits. Automated use within the published limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: nothing about you is stored.
7. Attribution. Qur'an text, translations and audio via alquran.cloud (Islamic Network); word-by-word, tafsir and introductions via the quran.com API (Quran Foundation); hadith via fawazahmed0/hadith-api (Unlicense), compiled from sunnah.com and other public sources. Individual translations and tafsirs remain the work of their authors and publishers; respect their terms when reusing output.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/quran

Quran support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://quran.connectorbay.com/mcp
• REST API: https://quran.connectorbay.com/openapi.json
• Live status: https://quran.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Quran never asks for them.