{"openapi":"3.1.0","info":{"title":"Quran API","version":"0.1.0","description":"The Qur'an (Arabic, 100+ translations, word-by-word, tafsir, search, audio) and the major hadith collections — read-only from open sources.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://quran.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/quran/docs"},"termsOfService":"https://connectorbay.com/quran/terms"},"servers":[{"url":"https://quran.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/quran/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/verse":{"post":{"operationId":"verse","summary":"A verse or range of verses: Arabic (Uthmani), the translation you ask for (Saheeh International by default; Urdu, Hindi,","description":"A verse or range of verses: Arabic (Uthmani), the translation you ask for (Saheeh International by default; Urdu, Hindi,\n    Bengali, French, Spanish, Indonesian, Turkish… by language code or translator name), transliteration on request, surah\n    name and meaning, juz and page, sajda flag, and per-verse recitation MP3s. Up to 30 verses per call. Use for \"what does\n    2:255 say\", \"Al-Kahf 1-10 in Urdu\", \"ayat al-kursi with transliteration\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ref":{"description":"Verse reference: '2:255', '2:255-257', 'Al-Baqarah 255', 'Yasin 1-5', 'surah 18 ayah 10', or 'ayat al-kursi'.","examples":["2:255","Yasin 1-5"],"title":"Ref","type":"string"},"translation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Translation edition or language: 'en.sahih' (default), 'pickthall', 'yusuf ali', 'asad', 'ur' (Jalandhry), 'ur.kanzuliman', 'hi', 'bn', 'fr', 'es', 'id', 'tr'… See the translations tool.","examples":["en.sahih","ur","pickthall"],"title":"Translation"},"extra_editions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"More editions alongside: e.g. ['en.transliteration', 'ur'].","title":"Extra Editions"},"reciter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Add recitation MP3 links: alafasy (default), husary, sudais, shuraim, abdulbasit, minshawi, muaiqly, shatri, hudhaify, ajamy, rifai, english. Omit for none.","title":"Reciter"}},"required":["ref"],"title":"verseArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/surah":{"post":{"operationId":"surah","summary":"A surah: its name, meaning, Meccan/Medinan, verse count and revelation order, a short introduction, and its verses in","description":"A surah: its name, meaning, Meccan/Medinan, verse count and revelation order, a short introduction, and its verses in\n    Arabic with the translation, paged 50 at a time. Use for \"Surah Yasin\", \"read Al-Mulk in Urdu\", \"Al-Baqarah from verse\n    200\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"surah":{"description":"Surah by number (1–114) or name: 'Yasin', 'Al-Kahf', 'The Cave', '36'.","examples":["Yasin","18"],"title":"Surah","type":"string"},"translation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Translation edition or language: 'en.sahih' (default), 'pickthall', 'yusuf ali', 'asad', 'ur' (Jalandhry), 'ur.kanzuliman', 'hi', 'bn', 'fr', 'es', 'id', 'tr'… See the translations tool.","examples":["en.sahih","ur","pickthall"],"title":"Translation"},"from_verse":{"default":1,"description":"First verse (1-based).","minimum":1,"title":"From Verse","type":"integer"},"limit":{"default":50,"description":"How many verses (1–50); page with from_verse for long surahs.","maximum":50,"minimum":1,"title":"Limit","type":"integer"},"with_intro":{"default":true,"description":"Include the surah's introduction (name, theme, period of revelation).","title":"With Intro","type":"boolean"}},"required":["surah"],"title":"surahArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/surah_info":{"post":{"operationId":"surah_info","summary":"The full introduction to a surah — its name, period and circumstances of revelation, theme and structure (Maududi's","description":"The full introduction to a surah — its name, period and circumstances of revelation, theme and structure (Maududi's\n    Tafhim al-Qur'an introductions, via quran.com), with the surah's metadata. Use for \"what is Surah Al-Kahf about\", \"when\n    was Surah Al-Fath revealed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"surah":{"description":"Surah by number (1–114) or name: 'Yasin', 'Al-Kahf', 'The Cave', '36'.","examples":["Yasin","18"],"title":"Surah","type":"string"},"language":{"default":"en","description":"Language of the introduction: en, ur, bn, ar…","title":"Language","type":"string"}},"required":["surah"],"title":"surah_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/surah_list":{"post":{"operationId":"surah_list","summary":"All 114 surahs: number, Arabic and English names, meaning, verse count, Meccan/Medinan, revelation order and page","description":"All 114 surahs: number, Arabic and English names, meaning, verse count, Meccan/Medinan, revelation order and page\n    range. Use for \"list the Medinan surahs\", \"which surah is number 67\", \"how many verses in Al-Baqarah\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"revelation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'makkah' or 'madinah' to filter.","title":"Revelation"}},"title":"surah_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_quran":{"post":{"operationId":"search_quran","summary":"Verses whose translation contains a word or phrase, with references and the matching text, across the whole Qur'an or","description":"Verses whose translation contains a word or phrase, with references and the matching text, across the whole Qur'an or\n    one surah. Searches the translation (English by default; give 'ur', 'fr'… for others). Use for \"verses about patience\",\n    \"where is Maryam mentioned\", \"which verse says 'with hardship comes ease'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Word or phrase to find in the translation: 'patience', 'mercy', 'orphans'.","examples":["patience"],"title":"Query","type":"string"},"translation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Translation edition or language: 'en.sahih' (default), 'pickthall', 'yusuf ali', 'asad', 'ur' (Jalandhry), 'ur.kanzuliman', 'hi', 'bn', 'fr', 'es', 'id', 'tr'… See the translations tool.","examples":["en.sahih","ur","pickthall"],"title":"Translation"},"surah":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Limit to one surah (number or name).","title":"Surah"},"limit":{"default":20,"description":"Max verses (1–50).","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"title":"search_quranArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tafsir":{"post":{"operationId":"tafsir","summary":"Classical and modern commentary on a verse: Ibn Kathir (abridged, English), Ma'ariful Qur'an, Tazkirul Qur'an; Ibn","description":"Classical and modern commentary on a verse: Ibn Kathir (abridged, English), Ma'ariful Qur'an, Tazkirul Qur'an; Ibn\n    Kathir, Tabari, Qurtubi, Sa'di, Baghawi, Muyassar in Arabic; Ibn Kathir, Bayan-ul-Qur'an, Fi Zilal in Urdu; Ibn Kathir,\n    Ahsanul Bayaan in Bengali. Tafsir often covers a group of verses; the covered range is returned. Use for \"tafsir of\n    2:255\", \"what does Ibn Kathir say about Al-Kahf 10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ref":{"description":"Verse reference: '2:255', '2:255-257', 'Al-Baqarah 255', 'Yasin 1-5', 'surah 18 ayah 10', or 'ayat al-kursi'.","examples":["2:255","Yasin 1-5"],"title":"Ref","type":"string"},"tafsir":{"default":"ibn-kathir","description":"One of: ibn-kathir, maarif-ul-quran, tazkirul-quran, ibn-kathir-ar, tabari, qurtubi, saadi, baghawi, muyassar, wasit, ibn-kathir-ur, bayan-ul-quran, fi-zilal, tazkirul-quran-ur, ibn-kathir-bn, ahsanul-bayaan, zakaria.","examples":["ibn-kathir","maarif-ul-quran"],"title":"Tafsir","type":"string"},"max_chars":{"default":8000,"description":"Trim long commentary (1000–30000).","maximum":30000,"minimum":1000,"title":"Max Chars","type":"integer"}},"required":["ref"],"title":"tafsirArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/word_by_word":{"post":{"operationId":"word_by_word","summary":"Each Arabic word of a verse with its transliteration and meaning, in order — for learning to read, memorising, or","description":"Each Arabic word of a verse with its transliteration and meaning, in order — for learning to read, memorising, or\n    understanding a phrase. One verse per call. Use for \"word by word of Al-Fatiha 1\", \"what does each word of 112:1 mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ref":{"description":"Verse reference: '2:255', '2:255-257', 'Al-Baqarah 255', 'Yasin 1-5', 'surah 18 ayah 10', or 'ayat al-kursi'.","examples":["2:255","Yasin 1-5"],"title":"Ref","type":"string"},"language":{"default":"en","description":"Language of the word meanings: en, ur, hi, bn, id, tr, fr…","title":"Language","type":"string"}},"required":["ref"],"title":"word_by_wordArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/juz":{"post":{"operationId":"juz","summary":"The verses of a juz (para) in order with surah and verse references, Arabic and translation, paged. Use for \"start of","description":"The verses of a juz (para) in order with surah and verse references, Arabic and translation, paged. Use for \"start of\n    juz 30\", \"read juz Amma in Urdu\", \"which surahs are in juz 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"Juz (para) number 1–30.","maximum":30,"minimum":1,"title":"Number","type":"integer"},"translation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Translation edition or language: 'en.sahih' (default), 'pickthall', 'yusuf ali', 'asad', 'ur' (Jalandhry), 'ur.kanzuliman', 'hi', 'bn', 'fr', 'es', 'id', 'tr'… See the translations tool.","examples":["en.sahih","ur","pickthall"],"title":"Translation"},"offset":{"default":0,"description":"Skip this many verses (for paging).","minimum":0,"title":"Offset","type":"integer"},"limit":{"default":30,"description":"Verses to return (1–50).","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["number"],"title":"juzArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/recitation":{"post":{"operationId":"recitation","summary":"Recitation audio: an MP3 link per verse (up to 50 per call) and, for the main reciters, the whole surah as one file.","description":"Recitation audio: an MP3 link per verse (up to 50 per call) and, for the main reciters, the whole surah as one file.\n    Use for \"play Surah Mulk by Sudais\", \"recitation of ayat al-kursi\", \"Al-Fatiha audio by Husary\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ref":{"description":"Verse reference: '2:255', '2:255-257', 'Al-Baqarah 255', 'Yasin 1-5', 'surah 18 ayah 10', or 'ayat al-kursi'.","examples":["2:255","Yasin 1-5"],"title":"Ref","type":"string"},"reciter":{"default":"alafasy","description":"alafasy, husary, husary-mujawwad, sudais, shuraim, abdulbasit, minshawi, muaiqly, shatri, hudhaify, ajamy, rifai, basfar, ayyoub, jibreel, sowaid, english.","examples":["alafasy","sudais"],"title":"Reciter","type":"string"}},"required":["ref"],"title":"recitationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/translations":{"post":{"operationId":"translations","summary":"The available editions: 100+ translations in 45+ languages, Arabic text variants (Uthmani, simple, Indo-Pak, tajweed),","description":"The available editions: 100+ translations in 45+ languages, Arabic text variants (Uthmani, simple, Indo-Pak, tajweed),\n    transliterations and Arabic tafsirs — with the identifier to pass to other tools. Use for \"which Urdu translations are\n    there\", \"list translations in French\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO language code to filter: en, ur, hi, bn, fr, es, id, tr…","title":"Language"}},"title":"translationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/verse_of_the_day":{"post":{"operationId":"verse_of_the_day","summary":"One verse for today (the same verse for everyone on a given date, cycling through the whole Qur'an), in Arabic with the","description":"One verse for today (the same verse for everyone on a given date, cycling through the whole Qur'an), in Arabic with the\n    translation, transliteration and surah context. Use for \"verse of the day\", \"give me an ayah to reflect on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"translation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Translation edition or language: 'en.sahih' (default), 'pickthall', 'yusuf ali', 'asad', 'ur' (Jalandhry), 'ur.kanzuliman', 'hi', 'bn', 'fr', 'es', 'id', 'tr'… See the translations tool.","examples":["en.sahih","ur","pickthall"],"title":"Translation"}},"title":"verse_of_the_dayArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hadith":{"post":{"operationId":"hadith","summary":"One hadith by collection and number: text in the language asked (English by default), the Arabic, the book/chapter it","description":"One hadith by collection and number: text in the language asked (English by default), the Arabic, the book/chapter it\n    sits in, gradings where the edition records them, and the sunnah.com link. Use for \"Bukhari 1\", \"Sahih Muslim 2699\",\n    \"the first hadith of Nawawi's 40\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"collection":{"description":"Hadith collection: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah, malik, nawawi (40 Hadith), qudsi (40 Qudsi), dehlawi.","examples":["bukhari","muslim"],"title":"Collection","type":"string"},"number":{"description":"Hadith number in the collection (the sunnah.com numbering).","minimum":1,"title":"Number","type":"integer"},"language":{"default":"en","description":"Hadith language: en, ar, ur, bn, fr, id, tr (ru/ta for some collections).","examples":["en","ar"],"title":"Language","type":"string"},"with_arabic":{"default":true,"description":"Also return the Arabic text.","title":"With Arabic","type":"boolean"}},"required":["collection","number"],"title":"hadithArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hadith_book":{"post":{"operationId":"hadith_book","summary":"Without a book number: the collection's table of contents (every book with its title and hadith range). With one: that","description":"Without a book number: the collection's table of contents (every book with its title and hadith range). With one: that\n    book's hadiths in order, paged. Use for \"what books are in Sahih Muslim\", \"Bukhari's Book of Revelation\", \"Tirmidhi's\n    chapters on fasting\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"collection":{"description":"Hadith collection: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah, malik, nawawi (40 Hadith), qudsi (40 Qudsi), dehlawi.","examples":["bukhari","muslim"],"title":"Collection","type":"string"},"book":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Book (chapter) number within the collection. Omit to list the books.","title":"Book"},"language":{"default":"en","description":"Hadith language: en, ar, ur, bn, fr, id, tr (ru/ta for some collections).","examples":["en","ar"],"title":"Language","type":"string"},"offset":{"default":0,"description":"Skip this many hadiths within the book.","minimum":0,"title":"Offset","type":"integer"},"limit":{"default":10,"description":"Hadiths to return (1–30).","maximum":30,"minimum":1,"title":"Limit","type":"integer"}},"required":["collection"],"title":"hadith_bookArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_hadith":{"post":{"operationId":"search_hadith","summary":"Full-text search across a hadith collection (or all major ones): every hadith whose text contains all the words, with","description":"Full-text search across a hadith collection (or all major ones): every hadith whose text contains all the words, with\n    number, book, grading and link. Use for \"hadith about intentions\", \"what did the Prophet say about neighbours\", \"hadith on\n    seeking knowledge in Ibn Majah\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Words to find (all must appear): 'intentions', 'neighbour', 'seeking knowledge'.","examples":["intentions"],"title":"Query","type":"string"},"collection":{"default":"all","description":"One collection, or 'all' for the six canonical books plus Nawawi's 40.","title":"Collection","type":"string"},"language":{"default":"en","description":"Hadith language: en, ar, ur, bn, fr, id, tr (ru/ta for some collections).","examples":["en","ar"],"title":"Language","type":"string"},"limit":{"default":10,"description":"Max hadiths (1–30).","maximum":30,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"title":"search_hadithArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hadith_collections":{"post":{"operationId":"hadith_collections","summary":"The ten collections available — Bukhari, Muslim, Abu Dawud, Tirmidhi, Nasa'i, Ibn Majah, Muwatta Malik, Nawawi's 40,","description":"The ten collections available — Bukhari, Muslim, Abu Dawud, Tirmidhi, Nasa'i, Ibn Majah, Muwatta Malik, Nawawi's 40,\n    40 Hadith Qudsi, Dehlawi's 40 — with the languages each is available in and the key to use in other tools.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"hadith_collectionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/names_of_allah":{"post":{"operationId":"names_of_allah","summary":"The 99 names of Allah (Asma ul-Husna): Arabic, transliteration and meaning — all of them, or the ones matching a name,","description":"The 99 names of Allah (Asma ul-Husna): Arabic, transliteration and meaning — all of them, or the ones matching a name,\n    meaning or number. Use for \"what does Al-Wadud mean\", \"which names mean merciful\", \"the 99 names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A name, meaning or number to look up: 'Al-Wadud', 'merciful', '47'. Omit for all 99.","title":"Query"}},"title":"names_of_allahArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}