hadith-mcp

A Model Context Protocol server that gives AI assistants verified access to the six canonical hadith collections — no hallucination.

What it does

LLMs frequently fabricate hadith citations. This MCP gives Claude (or any MCP-compatible AI) accurate retrieval from a local database of 34,178 hadiths.

Books included:

• Sahih al-Bukhari (7,277)
• Sahih Muslim (7,459)
• Sunan Abi Dawud (5,276)
• Jami at-Tirmidhi (4,053)
• Sunan an-Nasai (5,768)
• Sunan Ibn Majah (4,345)

Install (Claude Desktop)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hadith": {
      "command": "npx",
      "args": ["-y", "hadith-mcp"]
    }
  }
}

Restart Claude Desktop.

Tools

• search_hadith(query, book?, limit?) — keyword search (Arabic or English)
• get_hadith(book, number) — fetch by reference
• verify_hadith(text) — anti-hallucination check

Example usage

Ask Claude: "Find me a hadith about intentions" or "Is this hadith real: الطهور شطر الإيمان?"

Credits

• Data from AhmedBaset/hadith-json, originally sunnah.com
• MIT License

A note on grading

This dataset does not include per-hadith grading metadata. Sahih al-Bukhari and Sahih Muslim are considered authentic by scholarly consensus; the other four sunan books contain hadiths of varying authenticity. For scholarly use, consult qualified scholars.