# HadithDB (remote · hadithunlocked.com)

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

- Trust score: 79/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `hadithunlocked.com`: 79/100 (this document), [markdown](https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked.md), [page](https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked)

## Channel facts

- Endpoint: `https://hadithunlocked.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.2.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2441 tokens (~143/item across 17 items; 17 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 87/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 55% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 17 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the HadithDB MCP server?

HadithDB is a hosted endpoint at https://hadithunlocked.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http iadnanmukhtar-hadithdb 'https://hadithunlocked.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "iadnanmukhtar-hadithdb": {
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "iadnanmukhtar-hadithdb": {
      "type": "http",
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.iadnanmukhtar-hadithdb]
url = "https://hadithunlocked.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "iadnanmukhtar-hadithdb": {
      "type": "remote",
      "url": "https://hadithunlocked.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add iadnanmukhtar-hadithdb --url 'https://hadithunlocked.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  iadnanmukhtar-hadithdb:
    url: "https://hadithunlocked.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "iadnanmukhtar-hadithdb": {
      "Transport": "http",
      "Url": "https://hadithunlocked.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add iadnanmukhtar-hadithdb -t streamable-http -u 'https://hadithunlocked.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "iadnanmukhtar-hadithdb": {
      "type": "http",
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-19 (score 78, −1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “lookup_hadith_detail” rewrote its description, which is the text the model reads
- [security] Tool “lookup_quran_ayah” rewrote its description, which is the text the model reads
- [functional regression] Tool coverage: 72% → 55%
- [functional regression] Schema quality: 114 → 143
- [functional] Server version: 0.6.0 → 0.9.0
- [functional] New tool “get_quran_audio”
- [functional] New tool “list_hadith_commentaries”
- [functional] New tool “list_quran_reciters”
- [functional] New tool “list_quran_sections”
- [functional] New tool “lookup_hadith_commentary”
- [functional] New tool “lookup_quran_page”
- [functional] New tool “lookup_quran_passage”
- [functional] New tool “research_islamic_topic”
- [functional] New tool “research_quran_ayah”
- [functional] New tool “search_hadith_commentary”

### 2026-09-18 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-15 (score 77, 0)

- [security] Tool “lookup_hadith_detail” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: pass → fail
- [functional improvement] Tool coverage: 52% → 72%
- [functional improvement] Tool “list_tafsirs” now declares an output schema
- [functional improvement] Tool “lookup_hadith_detail” now declares an output schema
- [functional improvement] Tool “lookup_quran_ayah” now declares an output schema
- [functional improvement] Tool “lookup_tafsir” now declares an output schema
- [functional improvement] Tool “search_hadith” now declares an output schema
- [functional improvement] Tool “search_quran” now declares an output schema
- [functional improvement] Tool “search_tafsir” now declares an output schema
- [functional] First check of Tool coverage: 100
- [functional] Server version: 0.3.0 → 0.6.0
- [cosmetic] “list_tafsirs” added an optional parameter “cursor”
- [cosmetic] “lookup_hadith_detail” added an optional parameter “response_profile”
- [cosmetic] “lookup_tafsir” added an optional parameter “response_profile”
- [cosmetic] “search_hadith” added an optional parameter “cursor”
- [cosmetic] “search_quran” added an optional parameter “cursor”
- [cosmetic] “search_tafsir” added an optional parameter “cursor”
- [cosmetic] “lookup_tafsir” reworded the description of “max_chars”
- [cosmetic] “search_hadith” reworded the description of “offset”
- [cosmetic] “search_quran” reworded the description of “offset”
- [cosmetic] “search_tafsir” reworded the description of “offset”

### 2026-09-14 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-12 (score 76, +1)

- [security] Tool “search_hadith” rewrote its description, which is the text the model reads
- [cosmetic] “search_hadith” reworded the description of “books”

### 2026-09-10 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (17)

### `list_hadith_commentaries` (~77 tokens)

List hadith commentaries

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.

Input parameters:

- `limit` (integer)
- `offset` (integer)
- `query` (string)

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `next_offset` (integer|null)
- `sources` (array)
- `total` (integer)

### `search_hadith_commentary` (~125 tokens)

Search hadith commentary

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.

Input parameters:

- `cursor` (string)
- `limit` (integer)
- `query` (string, required)
- `reference` (string): Optional exact associated hadith reference.
- `source` (string): Optional exact commentary alias from list_hadith_commentaries.

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `pagination` (object)
- `query` (string)
- `results` (array)

### `lookup_hadith_commentary` (~69 tokens)

Look up hadith commentary

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.

Input parameters:

- `id` (integer, required)
- `response_profile` (string)

Output parameters:

- `commentary` (object)
- `error` (string): Error message when the tool could not complete the request.

### `research_islamic_topic` (~211 tokens)

Research an Islamic topic

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.

Input parameters:

- `depth` (string): Research breadth, independent of the final answer length. All depths have time and source limits.
- `hadith_references` (array): Known exact principal report references to prioritize and verify, e.g. bukhari:1166. Do not invent references or translate source numbers across collections.
- `queries` (array, required): Short concept search phrases, preferably including Arabic equivalents. Do not pass the entire natural-language question as a search phrase.
- `question` (string, required)

Output parameters:

- `coverage` (object)
- `depth` (string)
- `error` (string): Error message when the tool could not complete the request.
- `evidence` (array)
- `interpretation_note` (string)
- `next_steps` (array)
- `queries` (array)
- `question` (string)
- `scope` (string)

### `research_quran_ayah` (~257 tokens)

Research a Quran ayah and its concepts

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.

Input parameters:

- `ayah` (integer, required)
- `concepts` (array): Short concept search phrases, preferably including Arabic equivalents. Do not pass the entire natural-language question as a search phrase.
- `depth` (string): Research breadth, independent of the final answer length. All depths have time and source limits.
- `hadith_references` (array): Known exact principal report references to prioritize and verify, e.g. bukhari:1166. Do not invent references or translate source numbers across collections.
- `surah` (integer, required)
- `tafsirs` (array): Optional requested source names/aliases; overrides the default source selection.

Output parameters:

- `coverage` (object)
- `depth` (string)
- `error` (string): Error message when the tool could not complete the request.
- `evidence` (array)
- `interpretation_note` (string)
- `next_steps` (array)
- `queries` (array)
- `question` (string)
- `scope` (string)

### `lookup_quran_page` (~142 tokens)

Look up Quran page

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.

Input parameters:

- `ayah` (integer)
- `page` (integer)
- `response_profile` (string): Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved.
- `surah` (integer)

Output parameters:

- `ayahs` (array)
- `error` (string): Error message when the tool could not complete the request.
- `headings` (array)
- `mushaf` (object)
- `next_page` (integer|null)
- `page` (integer)
- `page_boundary_note` (string)
- `previous_page` (integer|null)
- `ranges` (array)
- `summary` (object)
- `url` (string)

### `list_quran_sections` (~130 tokens)

List Quran sections

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.

Input parameters:

- `limit` (integer)
- `offset` (integer)
- `response_profile` (string): Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved.
- `surah` (integer, required)

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `has_more` (boolean)
- `headings` (array)
- `next_offset` (integer|null)
- `offset` (integer)
- `surah` (integer)
- `total` (integer)
- `url` (string)

### `lookup_quran_passage` (~165 tokens)

Look up Quran passage

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.

Input parameters:

- `ayah` (integer): Ayah 0 is valid only in surah 1.
- `response_profile` (string): Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved.
- `section` (integer)
- `subsection` (integer)
- `surah` (integer, required)

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `first_page` (integer|null)
- `last_page` (integer|null)
- `mushaf_url` (string|null)
- `parent`
- `passage` (object)
- `subsections` (array)

### `list_quran_reciters` (~37 tokens)

List Quran reciters

List available Quran audio reciters and their aliases. Use this to resolve a requested reciter. Juhani is the default.

Output parameters:

- `default_reciter` (string)
- `error` (string): Error message when the tool could not complete the request.
- `reciters` (array)

### `get_quran_audio` (~185 tokens)

Get Quran passage audio

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.

Input parameters:

- `ayah_from` (integer, required)
- `ayah_to` (integer): Inclusive last ayah; defaults to ayah_from. For a whole surah, specify its first and last ayah.
- `reciter` (string): Reciter alias or exact catalog name. Defaults to Juhani.
- `surah` (integer, required)

Output parameters:

- `audio_url` (string): Full surah audio file; use the supplied timing boundaries for the requested passage.
- `end_ms` (integer)
- `error` (string): Error message when the tool could not complete the request.
- `playback_url` (string): Audio URL with a temporal media fragment in seconds. Client support varies.
- `reciter` (object)
- `reference` (string)
- `segments` (array)
- `start_ms` (integer)

### `lookup_quran_ayah` (~105 tokens)

Look up Quran ayah

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.

Input parameters:

- `ayah` (integer, required): Ayah number. Ayah 0 is valid only for Surah 1.
- `surah` (integer, required): Surah number, 1 through 114.

Output parameters:

- `ayah` (object): A normalized Quran, hadith, sirah, or history record.
- `error` (string): Error message when the tool could not complete the request.

### `search_quran` (~93 tokens)

Search Quran

Search Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.

Input parameters:

- `cursor` (string): Opaque cursor returned by the previous page. Do not modify it.
- `limit` (integer)
- `offset` (integer): Deprecated numeric pagination offset. Prefer cursor.
- `query` (string, required): Words or phrase to search for.
- `sort` (string)

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `offset` (integer)
- `pagination` (object)
- `query` (string)
- `results` (array)

### `list_tafsirs` (~79 tokens)

List tafsirs

Find available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.

Input parameters:

- `cursor` (string): Opaque cursor returned by the previous page. Do not modify it.
- `limit` (integer)
- `query` (string): Optional author, title, language, or alias filter.

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `has_more` (boolean)
- `next_cursor` (string|null)
- `query` (string|null)
- `tafsirs` (array)
- `total` (integer)

### `lookup_tafsir` (~129 tokens)

Look up tafsir

Retrieve commentary from a named HadithDB tafsir source for one Quran ayah.

Input parameters:

- `ayah` (integer, required)
- `language` (string): Preferred output language when available.
- `max_chars` (integer): Optional explicit character cap per language, overriding the selected response profile.
- `response_profile` (string): Controls response size. Compact shortens long commentary, default balances context and size, and full returns all stored text.
- `surah` (integer, required)
- `tafsir` (string, required): Alias, author, short name, or title, such as ibn-kathir.

Output parameters:

- `availability` (object)
- `commentary` (array)
- `error` (string): Error message when the tool could not complete the request.
- `reference` (string)
- `response_profile` (string)
- `source` (object): A normalized local tafsir source.
- `url` (string)

### `search_tafsir` (~107 tokens)

Search tafsir

Search HadithDB tafsir commentary, optionally restricting results to one named source.

Input parameters:

- `cursor` (string): Opaque cursor returned by the previous page. Do not modify it.
- `limit` (integer)
- `offset` (integer): Deprecated numeric pagination offset. Prefer cursor.
- `query` (string, required): Words or phrase to search for.
- `sort` (string)
- `tafsir` (string): Optional tafsir alias, author, short name, or title.

Output parameters:

- `error` (string): Error message when the tool could not complete the request.
- `offset` (integer)
- `pagination` (object)
- `query` (string)
- `results` (array)
- `source`

### `search_hadith` (~152 tokens)

Search hadith

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.

Input parameters:

- `books` (array): Optional HadithDB book aliases or groups such as sahihayn, sixbooks, ninebooks, sirah, or history. Either sirah or history searches all books of both historical types.
- `cursor` (string): Opaque cursor returned by the previous page. Do not modify it.
- `limit` (integer)
- `offset` (integer): Deprecated numeric pagination offset. Prefer cursor.
- `query` (string, required): Words or phrase to search for.

Output parameters:

- `books` (array)
- `error` (string): Error message when the tool could not complete the request.
- `offset` (integer)
- `pagination` (object)
- `query` (string)
- `results` (array)

### `lookup_hadith_detail` (~150 tokens)

Look up hadith detail

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". Compact includes an inventory of available commentary and verified related reports. For worship instructions or scholarly explanations, use research_islamic_topic and the commentary tools before answering.

Input parameters:

- `reference` (string, required): Reference such as bukhari:1, muslim:1907, or ahmad:1.6.
- `response_profile` (string): Compact returns the core record and is the default. Default adds bounded attribution, narrator, grading, reference, and commentary metadata. Full explicitly returns all stored provenance and metadata.

Output parameters:

- `canonical_url` (string)
- `error` (string): Error message when the tool could not complete the request.
- `records` (array)
- `requested_reference` (string)
- `response_profile` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked#diagnostics

## Score history

- 2026-09-20: 79
- 2026-09-19: 78
- 2026-09-18: 79
- 2026-09-17: 78
- 2026-09-16: 78
- 2026-09-15: 77
- 2026-09-14: 77
- 2026-09-13: 76
- 2026-09-12: 76
- 2026-09-11: 75
- 2026-09-10: 75
- 2026-09-09: 74
- 2026-09-08: 74
- 2026-09-07: 74
- 2026-09-06: 73
- 2026-09-05: 73

## Common questions

### What is the HadithDB MCP server?

HadithDB is an MCP server listed in the public MCP registry as io.github.iadnanmukhtar/hadithdb. Search and retrieve Quran ayahs, tafsir commentary, hadith, and detailed hadith records. This page covers its hosted endpoint (https://hadithunlocked.com/mcp).

### Is the HadithDB MCP server safe to use?

HadithDB scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the HadithDB MCP server expose?

HadithDB exposes 17 tools: list_hadith_commentaries, search_hadith_commentary, lookup_hadith_commentary, research_islamic_topic, research_quran_ayah, and 12 more. Their descriptions and schemas cost roughly 2,213 tokens of context every time the server is loaded.

### Does the HadithDB MCP server require authentication?

No. We connected to HadithDB without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the HadithDB MCP server still maintained?

HadithDB is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://hadithunlocked.com/mcp
- Repository: https://github.com/iadnanmukhtar/hadithdb
- Website: https://hadithunlocked.com/
- Changelog RSS feed: https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked.xml
- Changelog JSON feed: https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked.json
- HTML version of this page: https://verifymcp.io/servers/iadnanmukhtar-hadithdb/hadithunlocked