HadithDB

by iadnanmukhtar · remote · no sign-in to list tools · v0.2.0 · published by GitHub user iadnanmukhtar

Search and retrieve Quran ayahs, tafsir commentary, hadith, and detailed hadith records.

Changes · 2

Compare Registry entry

17 tools: 2 change things and 15 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things2Claude Code: ask: see these tools
Only reads15Claude Code: allow: see these tools

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http hadithdb https://hadithunlocked.com/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

17 tools

Changes things 2Creates or changes something that can be changed back.Claude Code: ask

research_islamic_topicUse this before answering substantive Islamic topic or practical worship questions, such as what istikharah is and how to pray it.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
Use 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/English queries and known principal hadith_references when available to anchor the research. Inspect coverage and fetch omitted/truncated sources as needed within the same turn; do not treat topic matches as direct evidence or claim exhaustive research.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
research_quran_ayahUse this for explanations of Quran ayahs.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
Use 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 grounded concept phrases, and call again with concepts without asking the user. Search matches are conceptual candidates, not proof a hadith directly explains this ayah. Verify relevant source text before synthesis. Respect explicitly requested tafsir sources.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true

Only reads 15Looks things up and changes nothing.Claude Code: allow

get_quran_audioGet an audio URL and exact ayah timing segments for a Quran passage by a selected reciter (default: Juhani).No findings
Why it is in this group
- The name "get_quran_audio" says "get": a word for reading.
Description, as the server wrote it
Get 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 order. Use list_quran_reciters for available names and aliases. Clients must seek to start_ms and stop at end_ms; the URL points to the full surah.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_hadith_commentariesUse this to discover available hadith commentary works (shuruh), authors and aliases before selecting a source.No findings
Why it is in this group
- The name "list_hadith_commentaries" says "list": a word for reading.
Description, as the server wrote it
Use 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_quran_recitersList available Quran audio reciters and their aliases.No findings
Why it is in this group
- The name "list_quran_reciters" says "list": a word for reading.
Description, as the server wrote it
List available Quran audio reciters and their aliases. Use this to resolve a requested reciter. Juhani is the default.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_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 …No findings
Why it is in this group
- The name "list_quran_sections" says "list": a word for reading.
Description, as the server wrote it
List 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_tafsirsFind available HadithDB tafsir sources and aliases.No findings
Why it is in this group
- The name "list_tafsirs" says "list": a word for reading.
Description, as the server wrote it
Find available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_hadith_commentaryRetrieve an exact scholarly commentary entry by ID from commentary search or a hadith’s research inventory.No findings
Why it is in this group
- The name "lookup_hadith_commentary" says "lookup": a word for reading.
Description, as the server wrote it
Retrieve 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_hadith_detailRetrieve the core Arabic and English text, chain, headings, grades, and canonical URL for an exact hadith reference.No findings
Why it is in this group
- The name "lookup_hadith_detail" says "lookup": a word for reading.
Description, as the server wrote it
Retrieve 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 information, attached commentary identities, and related report references only (no narration text). For worship instructions or scholarly explanations, use research_islamic_topic and the commentary tools before answering.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_quran_ayahRetrieve the exact Arabic text, English translation, headings, and canonical URL for one Quran ayah.No findings
Why it is in this group
- The name "lookup_quran_ayah" says "lookup": a word for reading.
Description, as the server wrote it
Retrieve 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_quran_pageGet a Mushaf page by page number, or find the first page containing a surah and ayah.No findings
Why it is in this group
- The name "lookup_quran_page" says "lookup": a word for reading.
Description, as the server wrote it
Get 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 authored summary or Quran text. Ayahs and passages may continue across pages.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_quran_passageGet an exact Quran passage by surah and section number, optionally subsection; or find the passage containing a surah and ayah.No findings
Why it is in this group
- The name "lookup_quran_passage" says "lookup": a word for reading.
Description, as the server wrote it
Get 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, not an ayah number. Use list_quran_sections to discover section IDs.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
lookup_tafsirRetrieve commentary from a named HadithDB tafsir source for one Quran ayah.No findings
Why it is in this group
- The name "lookup_tafsir" says "lookup": a word for reading.
Description, as the server wrote it
Retrieve commentary from a named HadithDB tafsir source for one Quran ayah.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
search_hadithSearch Arabic or English hadith, sirah, and history text, optionally within selected book aliases or virtual book groups.No findings
Why it is in this group
- The name "search_hadith" says "search": a word for reading.
Description, as the server wrote it
Search 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
search_hadith_commentaryUse this for scholarly explanations, procedural details and disagreements, including when answering how to perform worship or researching Quranic concepts.No findings
Why it is in this group
- The name "search_hadith_commentary" says "search": a word for reading.
Description, as the server wrote it
Use 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_hadith_commentary and verify reports with lookup_hadith_detail.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
search_quranSearch Quran Arabic text and English translations by words or phrases.No findings
Why it is in this group
- The name "search_quran" says "search": a word for reading.
Description, as the server wrote it
Search Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
search_tafsirSearch HadithDB tafsir commentary, optionally restricting results to one named source.No findings
Why it is in this group
- The name "search_tafsir" says "search": a word for reading.
Description, as the server wrote it
Search HadithDB tafsir commentary, optionally restricting results to one named source.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.2.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http hadithdb https://hadithunlocked.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__hadithdb__list_hadith_commentaries",
      "mcp__hadithdb__search_hadith_commentary",
      "mcp__hadithdb__lookup_hadith_commentary",
      "mcp__hadithdb__lookup_quran_page",
      "mcp__hadithdb__list_quran_sections",
      "mcp__hadithdb__lookup_quran_passage",
      "mcp__hadithdb__list_quran_reciters",
      "mcp__hadithdb__get_quran_audio",
      "mcp__hadithdb__lookup_quran_ayah",
      "mcp__hadithdb__search_quran",
      "mcp__hadithdb__list_tafsirs",
      "mcp__hadithdb__lookup_tafsir",
      "mcp__hadithdb__search_tafsir",
      "mcp__hadithdb__search_hadith",
      "mcp__hadithdb__lookup_hadith_detail"
    ],
    "ask": [
      "mcp__hadithdb__research_islamic_topic",
      "mcp__hadithdb__research_quran_ayah"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as hadithdb. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.iadnanmukhtar/hadithdb/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

2 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry · repository. Synced Oct 21, 2026, 18:36 UTC.

For agents: Markdown · JSON · report this listing