mcpbeat Sign in

HadithDB MCP Server

by iadnanmukhtar Your server? Claim it
answering

HadithDB is answering right now. Last checked 2 min ago. It exposes 7 tools. Last commit 18 Sep 2026.

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

Uptime history 14 days of history · worst day 98%
14 days agonow
98.9%
Uptime 24h
91 of 92 checks
7
Tools
read from the server
471 ms
Response time
average over 24h
6
Stars
last commit 18 Sep 2026

What changed 6

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 6 September 2026. No other catalogue keeps this.

15 Sep a tool changed version2 times that day
14 Sep a tool changed version
12 Sep a tool description was rewritten search_hadith
12 Sep a tool changed the parameters it asks for search_hadith
6 Sep a tool changed version
and 1 more, back to 6 September 2026

What the code does

We read the source, 1 h ago · tools taken from the live server · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

            const cacheFile = path.join(CACHE_DIR, row.source_book_slug, `${row.source_entry_id}.json.gz`);
        SELECT id
        FROM books
        WHERE alias=${mysql.escape(alias)}
Runs an external command services/quran-asr/quran_asr/app.py:50
    completed = subprocess.run(
Reads files and sends them to the network lib/Utils.js:2502
            for (const entry of fsSync.readdirSync(directory)) {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

run in your terminal
claude mcp add hadithdb --transport http https://hadithunlocked.com/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "hadithdb": {
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.hadithdb]
url = "https://hadithunlocked.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "hadithdb": {
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "hadithdb": {
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}

Available tools 7

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

lookup
lookup_hadith_detail
Retrieve the full Arabic and English text, chain, headings, grades, scholarly metadata, and canonical URL for an exact hadith reference.
lookup_quran_ayah
Retrieve the Arabic text, English translation, headings, and canonical URL for one Quran ayah by numeric reference.
lookup_tafsir
Retrieve commentary from a named HadithDB tafsir source for one Quran ayah.
hadith
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.
quran
search_quran
Search Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.
tafsir
search_tafsir
Search HadithDB tafsir commentary, optionally restricting results to one named source.
tafsirs
list_tafsirs
Find available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.

Endpoints

URLTransportStateLatencyChecked
https://hadithunlocked.com/mcp streamable-http answering 473 ms 2 min ago

Alternatives to HadithDB

same job, measured the same way
There's An AI For That
by theresanaiforthat

Search TAAFT for AI tools and retrieve public tool details.

answering
backscroll
by soren-achebe

Search, retrieve, and diff the full output of past terminal commands recorded locally by backscroll.

local only
RU Books MCP
by books-service

MCP server for Russian books search, details, and recommendation candidates.

8 tools answering
Appsignal
by pulsemcp

MCP server for AppSignal — get alert details, search logs, and retrieve logs within time ranges.

96 installs/wk local only
Ao3 MCP
by arturlys

Search AO3 and have fics read by a secondary model before they're recommended

166 installs/wk local only
Hadith Checker [Dorar.net]
by ibnsaleem29

Research Hadith, authenticity, grading, Takhrij and Sharh [commentaries] in Claude Desktop for free.

local only
Dida MCP Server
by nathishdev-netizen

Hotel search, booking, and review MCP server with 12+ detailed fields per hotel

86 installs/wk local only
hackernews
by pipeworx-io

Hacker News MCP — search and retrieve stories from Hacker News

41 tools answering

HadithDB — questions

Answers built from our own checks of this server.

What can HadithDB do?
It exposes 7 tools, read directly from the server on our last check. Among them: list_tafsirs, lookup_hadith_detail, lookup_quran_ayah, lookup_tafsir, search_hadith, search_quran and 1 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is HadithDB working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 92 checks got a reply (98.9%), average response time 471 ms. The bar chart above shows every period we have measured.
How do I connect HadithDB?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does HadithDB need an API key?
No. HadithDB completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 7 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is HadithDB?
It answers our handshake in 471 ms on average, which is faster than 31% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
Is HadithDB open source?
We cannot say either way: written in HTML, 6 stars on GitHub and 2 open issues, but we could not determine the licence, and without one the code is not open source by default.