protogrid

Search / io.github.iadnanmukhtar/hadithdb

HadithDB

not classified

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

v0.2.0 · active · repository · website · descriptor JSON · versions

Not classified yet.The remote endpoints have not been probed successfully, or the listing has nothing to connect to.
Quality100strong
Trust94of 100
Uptime, 30 days97%
Latency p50155 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "hadithdb": {
      "type": "http",
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
claude mcp add --transport http hadithdb https://hadithunlocked.com/mcp
[mcp_servers.hadithdb]
url = "https://hadithunlocked.com/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hadithdb": {
      "type": "remote",
      "url": "https://hadithunlocked.com/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "hadithdb": {
      "type": "http",
      "url": "https://hadithunlocked.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hadithdb&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vaGFkaXRodW5sb2NrZWQuY29tL21jcCJ9"
}
{
  "servers": {
    "hadithdb": {
      "type": "http",
      "url": "https://hadithunlocked.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "hadithdb": {
      "httpUrl": "https://hadithunlocked.com/mcp"
    }
  }
}
extensions:
  "hadithdb":
    enabled: true
    name: "hadithdb"
    type: streamable_http
    uri: "https://hadithunlocked.com/mcp"
    timeout: 300

Quality 100 / 100strong

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations17 of 17 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 3,985 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history not recorded yet
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

17 tools, about 3,985 tokens to load them all · checked 2026-10-20 10:03 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
liveness99
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-45d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://hadithunlocked.com/mcp streamable-httpunknownyes97%155 ms–2026-10-20

Tools (17)

get_quran_audioread-onlyGet 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.
list_hadith_commentariesread-onlyUse 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.
list_quran_recitersread-onlyList available Quran audio reciters and their aliases. Use this to resolve a requested reciter. Juhani is the default.
list_quran_sectionsread-onlyList 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.
list_tafsirsread-onlyFind available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.
lookup_hadith_commentaryread-onlyRetrieve 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.
lookup_hadith_detailread-onlyRetrieve 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.
lookup_quran_ayahread-onlyRetrieve 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.
lookup_quran_pageread-onlyGet 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.
lookup_quran_passageread-onlyGet 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.
lookup_tafsirread-onlyRetrieve commentary from a named HadithDB tafsir source for one Quran ayah.
research_islamic_topicread-onlyUse 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.
research_quran_ayahread-onlyUse 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.
search_hadithread-onlySearch 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.
search_hadith_commentaryread-onlyUse 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.
search_quranread-onlySearch Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.
search_tafsirread-onlySearch HadithDB tafsir commentary, optionally restricting results to one named source.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.iadnanmukhtar/hadithdb",
  "title": "HadithDB",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://hadithunlocked.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.2.0",
  "repository": {
    "url": "https://github.com/iadnanmukhtar/hadithdb",
    "source": "github"
  },
  "websiteUrl": "https://hadithunlocked.com",
  "description": "Search and retrieve Quran ayahs, tafsir commentary, hadith, and detailed hadith records."
}