Skip to content
MCP server

Madeenan Quran and Hadith Sources

Read-only MCP server for citing Quran, Hadith, Tafsir and dua sources in AI answers

Runs locallyStatus and history
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-mcp

Add 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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity