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
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.
What You'll Need
Set these up before or after installing:
Environment variable: MADEENAN_API_KEY
Environment variable: MADEENAN_API_BASE_URL
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 GitHubFrom 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.
| Package | Path | Install |
|---|---|---|
TypeScript SDK @madeenan/sdk | packages/sdk | see packages/sdk/README.md |
React components @madeenan/react | packages/react | see packages/react/README.md |
React Native components @madeenan/react-native | packages/react-native | see packages/react-native/README.md |
Python SDK madeenan-sdk | packages/python | see packages/python/README.md |
MCP server madeenan-mcp | apps/mcp | see 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_bundleandreview_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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
