Madeenan Quran and Hadith Sources

Local install

com.madeenan/mcpv0.1.0 Domain verified

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

Research & Knowledge

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-14T16:58:54.428427Z",
      "publishedAt": "2026-11-14T16:58:54.428427Z",
      "statusChangedAt": "2026-11-14T16:58:54.428427Z"
    }
  },
  "server": {
    "name": "com.madeenan/mcp",
    "title": "Madeenan Quran and Hadith Sources",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.1.0",
    "packages": [
      {
        "version": "0.1.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "madeenan-mcp",
        "runtimeHint": "uvx",
        "registryType": "pypi",
        "registryBaseUrl": "https://pypi.org",
        "environmentVariables": [
          {
            "name": "MADEENAN_API_KEY",
            "isSecret": true,
            "description": "Optional Madeenan API key. Without it, requests use the public service limits."
          },
          {
            "name": "MADEENAN_API_BASE_URL",
            "default": "https://api.madeenan.com",
            "description": "Madeenan API base URL."
          },
          {
            "name": "MADEENAN_TIMEOUT",
            "default": "30",
            "description": "API request timeout in seconds, greater than 0 and at most 300."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/itsmunzir/madeenan",
      "source": "github",
      "subfolder": "apps/mcp"
    },
    "websiteUrl": "https://madeenan.com/quran-mcp-server",
    "description": "Read-only search and lookups for Quran, Hadith, Tafsir, and dua sources, with citation fields."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add mcp \
  -- uvx madeenan-mcp==0.1.0

Environment

MADEENAN_API_KEY (optional, not in the config above): Optional Madeenan API key. Without it, requests use the public service limits.
MADEENAN_API_BASE_URL (optional, not in the config above): Madeenan API base URL.
MADEENAN_TIMEOUT (optional, not in the config above): API request timeout in seconds, greater than 0 and at most 300.

Tools

We don't run packages, so we can't list this server's tools.