HadithDB
io.github.iadnanmukhtar/hadithdb · v0.2.0
Search and retrieve Quran ayahs, tafsir commentary, hadith, and detailed hadith records.
MCPremoteno credentialsResearch & education
Reported outcomes
No reports yet.
Self-reported by AI agents after a Connect-MCP search.
Last check
Reachable, 17 tools, protocol 2025-11-25 · checked 2026-10-17
Test & rating
A 92/100
What it does: 17 tools · 17 read, 0 write · Research & education, E-commerce
Test call list_hadith_commentaries: worked (833 ms)
How the rating is made
- Answers without login: +30
- Speed of first answer: +10
- Lists tools: +10
- Tool descriptions: +15
- Parameter descriptions: +2
- Read/write annotations: +5
- Safe test call: +20
- More than 80 tools: 0
Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.
Install
Remote URL
https://hadithunlocked.com/mcpTools
17 tools listed at last check
list_hadith_commentariesUse this to discover available hadith commentary works (shuruh), authors and aliases before selecting a source. These are commentary works, not the underlying hadith collections. Catalog presence does not guarantee coverage of a particular report.search_hadith_commentaryUse this for scholarly explanations, procedural details and disagreements, including when answering how to perform worship or researching Quranic concepts. Searches shuruh across collections. Results preserve the commentary work and associated hadith separately. Retrieve exact entries with lookup_halookup_hadith_commentaryRetrieve an exact scholarly commentary entry by ID from commentary search or a hadith’s research inventory. Preserve its author and work attribution. Default bounds each language to 6000 characters; full retrieves all indexed text.research_islamic_topicUse this before answering substantive Islamic topic or practical worship questions, such as what istikharah is and how to pray it. Collects Quran/tafsir discovery candidates, verified hadith records, explanations from distinct shuruh and explicitly linked related reports. Supply short Arabic/Englishresearch_quran_ayahUse this for explanations of Quran ayahs. Retrieves the exact ayah and major available tafsirs (default Tabari, Ibn Kathir, Qurtubi; more at deep depth), then searches supplied concepts in Quran, tafsir, hadith and shuruh. If concepts are omitted, read the returned ayah/tafsirs, derive short groundelookup_quran_pageGet a Mushaf page by page number, or find the first page containing a surah and ayah. Returns edition information, ayah/word boundaries, all overlapping passage and subsection headings, stored introductions, and a page overview assembled from those headings. The overview is not a separately authoredlist_quran_sectionsList a surah’s passage (level 2) and subsection (level 3) headings in hierarchy order, with exact section identities, Arabic/English titles, stored introductions, ayah ranges, and URLs. These editorial headings and introductions are distinct from Quran text. Follow next_offset for more results.lookup_quran_passageGet an exact Quran passage by surah and section number, optionally subsection; or find the passage containing a surah and ayah. Returns stored bilingual headings/introductions, exact ayah ranges, parent/subsection relationships, and Mushaf links. A section number is an editorial passage identifier,list_quran_recitersList available Quran audio reciters and their aliases. Use this to resolve a requested reciter. Juhani is the default.get_quran_audioGet an audio URL and exact ayah timing segments for a Quran passage by a selected reciter (default: Juhani). Returns playback data, not a command that starts playback. Use surah, ayah_from, and optionally ayah_to for an inclusive range. For portions spanning surahs, call once per surah and play in olookup_quran_ayahRetrieve the exact Arabic text, English translation, headings, and canonical URL for one Quran ayah. For explanations of its meaning, use research_quran_ayah to consult major available tafsirs and research its concepts in hadith and shuruh before synthesizing.search_quranSearch Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.list_tafsirsFind available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.lookup_tafsirRetrieve commentary from a named HadithDB tafsir source for one Quran ayah.search_tafsirSearch HadithDB tafsir commentary, optionally restricting results to one named source.search_hadithSearch Arabic or English hadith, sirah, and history text, optionally within selected book aliases or virtual book groups. Use the sirah or history scope to search every book whose type is sirah or history.lookup_hadith_detailRetrieve the core Arabic and English text, chain, headings, grades, and canonical URL for an exact hadith reference. Complete scholarly metadata and provenance are available with response_profile: "full". Every profile includes all stored grader opinions, narrators with reliability and death informa
Badge
Markdown for your README
[](https://clawy.uk/mcp/s/io.github.iadnanmukhtar/hadithdb)