# HadithDB

HadithDB lets an agent search Quran ayahs, tafsir, and hadith records, then inspect source details. It fits research workflows that run through MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: iadnanmukhtar
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/iadnanmukhtar/hadithdb
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/hadithdb

## What it does

HadithDB connects an agent to Quran and hadith data through a read-only Streamable HTTP MCP server. It supports searches for ayahs, tafsir, and hadith, plus detailed record lookups with narrator chains, grading data, and related reports. Topic work runs through `research_islamic_topic`; ayah-focused work uses `research_quran_ayah`.

The server also exposes a hadith-commentary catalog, Quran navigation data, and audio playback metadata. Records may include Arabic and English separately when both are stored. Search results use pagination and time limits, while research dossiers separate direct tafsir, exact reports, linked reports, and search candidates. They are not exhaustive surveys or generated rulings.

Connect to `https://hadithunlocked.com/mcp`; the setup does not require an API key. The service is read-only. Its time and source bounds mean that important conclusions should be checked against coverage, with shortened or omitted sources retrieved separately.

## Requirements
- Remote server: `https://hadithunlocked.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hadithdb https://hadithunlocked.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hadithdb --url https://hadithunlocked.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hadithdb": {
            "url": "https://hadithunlocked.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hadithdb": {
            "type": "http",
            "url": "https://hadithunlocked.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hadithdb https://hadithunlocked.com/mcp
```

## When to use it
- search Quran ayahs by topic or wording
- compare a hadith with tafsir commentary
- inspect a hadith record in detail
- review narrator chains and grading data
- assemble a research dossier for an Islamic question

## Example prompts
- Search for Quran ayahs and tafsir about patience, then show which sources were found.
- Use `research_quran_ayah` for surah 2, ayah 255, and separate stored tafsir from your own explanation.
- Look up a hadith from its reference and return its narrators, grading data, and related reports.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md