Madeenan Quran and Hadith Sources
Read-only MCP server for citing Quran, Hadith, Tafsir and dua sources in AI answers
- Pricing
- Freemium
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 2 days ago
About Madeenan Quran and Hadith Sources
Madeenan Quran and Hadith Sources is a freemium MCP server for religion. It runs locally on your machine and is started by your AI client.
The design goal is retrieval, not answers: the server hands a model source records and exact references so the reply can quote what was actually fetched. Every tool returns reference and source fields, which lets you ask the assistant to cite them and check yourself. The site says it covers the Quran, six Hadith collections with grade metadata, five Tafsir editions and the Hisn al-Muslim duas, with one English Quran translation and no word-level morphology.
Two tools help with review rather than lookup. One bundles search results and up to eight Quran references into a single package, and the other returns a checklist marked for human review. The docs are explicit that neither verifies a claim or issues a ruling, and that interpretation belongs with qualified scholars.
It runs locally over stdio on Python 3.11 or newer. An API key is optional for the current tools and is read from the environment, never from a tool argument. Streamable HTTP exists for self-hosting, but it has no inbound authentication, so put a gateway with TLS in front of it. There is no public hosted endpoint.
Install
Run in a terminal
claude mcp add mcp --env MADEENAN_API_KEY='<MADEENAN_API_KEY>' -- uvx madeenan-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"madeenan-mcp"
],
"env": {
"MADEENAN_API_KEY": "<MADEENAN_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"madeenan-mcp"
],
"env": {
"MADEENAN_API_KEY": "<MADEENAN_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"madeenan-mcp"
],
"env": {
"MADEENAN_API_KEY": "<MADEENAN_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"madeenan-mcp"
],
"env": {
"MADEENAN_API_KEY": "<MADEENAN_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"madeenan-mcp"
],
"env": {
"MADEENAN_API_KEY": "<MADEENAN_API_KEY>"
}
}
}
}Configuration
MADEENAN_API_KEYOptional Madeenan API key. Without it, requests use the public service limits.MADEENAN_API_BASE_URLMadeenan API base URL.MADEENAN_TIMEOUTAPI request timeout in seconds, greater than 0 and at most 300.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- search_islamic_sources
- Search Quran, Hadith, Tafsir and dua sources
- lookup_quran_reference
- Read one verse, a chapter or a passage of up to 50 ayahs
- lookup_hadith_reference
- Read one Hadith by collection and number, with grade metadata
- lookup_dua
- Read one dua or adhkar item by collection and item ID
- find_quote_source
- Find wording matches for a quote
- create_evidence_bundle
- Collect search results and Quran references into one bundle for review
- review_evidence_claim
- Return an evidence checklist marked for human review
What it does
- Cross-source search
- Searches Quran, Hadith, Tafsir and dua sources with a 1 to 25 result limit and an optional Hadith grade filter.
- Exact reference lookup
- Reads a verse, a chapter or a passage of up to 50 ayahs, or a Hadith by collection and number.
- Quote source finder
- Finds wording matches for a quote, without claiming authorship or meaning.
- Evidence bundles
- Collects search results and up to eight Quran references for review.
- Human-review checklist
- Returns an evidence checklist marked needs_human_review.
- Key kept out of output
- The API key is never returned in tool output, errors or logs.
Good for
- Check where a quoted verse or Hadith actually appears
- Gather sources on a topic before writing a study note
- Read a Hadith with its grade metadata
- Look up a dua by collection and item
- Give a research assistant citable references
Pricing
Freemium
Free search is 10 a day; Starter allows 3,000 searches a month and the API plan 30,000; prices not published.
Prices change. Check madeenan.com before you buy.
Madeenan Quran and Hadith Sources FAQ
Does it issue religious rulings?
No. It retrieves sources and prepares evidence for review; interpretation is left to qualified scholars.
Do I need an API key?
It is optional for the current tools. Without one, public service limits apply.
Is there a hosted endpoint?
No. You run the server yourself, over stdio locally or Streamable HTTP behind your own gateway.
What does it need to run?
Python 3.11 or newer and an MCP host such as Claude Desktop or Cursor.
Is Madeenan Quran and Hadith Sources free?
Madeenan Quran and Hadith Sources has a free plan, with paid plans for more usage or features.
How do I add Madeenan Quran and Hadith Sources to Claude Code?
Run this command in your terminal: claude mcp add mcp --env MADEENAN_API_KEY='<MADEENAN_API_KEY>' -- uvx madeenan-mcp
What are the best alternatives to Madeenan Quran and Hadith Sources?
The closest alternatives to Madeenan Quran and Hadith Sources are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Madeenan Quran and Hadith Sources

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory