Back to Browse

Madeenan MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Read-only search and lookups for Quran, Hadith, Tafsir, and dua sources, with citation fields.

About

Read-only search and lookups for Quran, Hadith, Tafsir, and dua sources, with citation fields.

Security Report

6.2
Moderate6.2Moderate Risk

This is a read-only MCP server and client libraries for the Madeenan Quran and Hadith API, with API key authentication via environment-supplied credentials, input validation on path segments and query bounds, and no hardcoded secrets or shell execution in the visible code. The network access to the Madeenan API and the lookup-oriented permissions match the server's stated purpose for a developer tool. Minor observations are limited to the truncated react-native source and the fact that the MCP server source files beyond cli.py were not included for review. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

10 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional Madeenan API key. Without it, requests use the public service limits.Required

Environment variable: MADEENAN_API_KEY

Madeenan API base URL.Optional

Environment variable: MADEENAN_API_BASE_URL

API request timeout in seconds, greater than 0 and at most 300.Optional

Environment variable: MADEENAN_TIMEOUT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "madeenan-mcp": {
      "command": "uvx",
      "args": [
        "madeenan-mcp==0.1.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

Madeenan: Quran and Hadith API clients and MCP server

Open-source clients for the Madeenan Quran and Hadith API. Search Quran, Hadith, Tafsir and dua sources, read exact references, check where a quote comes from, and get answers that cite their sources.

The search, ranking and source data run on the hosted Madeenan API. This repository contains the client libraries and the MCP server that call it.

PackagePathInstall
TypeScript SDK @madeenan/sdkpackages/sdksee packages/sdk/README.md
React components @madeenan/reactpackages/reactsee packages/react/README.md
React Native components @madeenan/react-nativepackages/react-nativesee packages/react-native/README.md
Python SDK madeenan-sdkpackages/pythonsee packages/python/README.md
MCP server madeenan-mcpapps/mcpsee apps/mcp/README.md

Quick example (TypeScript)

import { createMadeenanClient } from "@madeenan/sdk";

const madeenan = createMadeenanClient({ apiKey: process.env.MADEENAN_API_KEY });

const search = await madeenan.search({
  q: "patience and prayer",
  indexes: ["quran", "hadith"],
});

for (const result of search.results.quran ?? []) {
  console.log(result.ref, result.excerpt ?? result.translation);
}

Keep the API key on your server. Do not put it in code that runs in a browser.

MCP tools

The MCP server lets Claude, Cursor and other MCP clients look up sources instead of answering from memory:

  • search_islamic_sources: search Quran, Hadith, Tafsir and dua records.
  • lookup_quran_reference: read a verse, chapter or passage.
  • lookup_hadith_reference: read a Hadith with its recorded grade.
  • lookup_dua: read a dua or adhkar item.
  • find_quote_source: find where a wording appears. A match does not prove authorship.
  • create_evidence_bundle and review_evidence_claim: collect sources for a claim and prepare a checklist. They do not verify a claim or its meaning.

Links

The API contract the SDKs are tested against is in contracts/public-openapi.json.

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!