Skip to main content
Glama

quran-mcp

An MCP server providing canonical Quran text, translations, and tafsir commentary — sourced from quran.com.

What this is

quran-mcp is a Model Context Protocol server that gives AI assistants grounded access to the Quran. Instead of relying on training data (which can misquote, fabricate, or confuse verses), the AI fetches verified text through structured tool calls.

Why this matters: For Muslims, the Quran is the literal word of God. Misquoting it is not an acceptable error mode. This server exists so AI assistants can cite accurately, attribute properly, and defer to scholarly commentary rather than inventing interpretations.

Related MCP server: Quranpedia MCP

Capabilities

  • Quran text — Arabic text in multiple qira'at (Hafs, Warsh, Qaloon, etc.)

  • Translations — 50+ translations across 30+ languages

  • Tafsir — Classical and modern exegesis from 15+ scholars (Ibn Kathir, al-Tabari, al-Qurtubi, al-Sa'di, and more)

  • Search — Full-text search across Quran text, translations, and tafsir

  • Morphology — Word-level grammatical analysis, root concordance, paradigm tables

  • Mushaf viewer — Visual mushaf page rendering

Quick start

Add to your MCP client configuration:

{
  "mcpServers": {
    "quran": {
      "url": "https://mcp.quran.ai",
      "type": "http"
    }
  }
}

Works with Claude Desktop, ChatGPT, and any MCP-compatible client.

Self-hosted

git clone https://github.com/quran/quran-mcp.git
cd quran-mcp
cp .env.example .env        # fill in database password
docker compose up -d         # starts postgres + server

The server runs at http://localhost:8088.

For integration patterns beyond basic hosting, see docs/SETUP.md. It documents both MCP-server composition (for sibling servers such as quran-mcp-auth) and client-style consumption (for apps such as quran-mcp-admin).

Project structure

src/quran_mcp/
  server.py              Entry point
  mcp/                   Client-facing MCP surface
    tools/               fetch_quran, search_tafsir, etc.
    resources/           MCP resources
    prompts/             MCP prompts
  lib/                   Business logic and utilities
  middleware/            Request pipeline (rate limiting, grounding, logging)
  apps/                  Frontend apps (documentation site, mushaf viewer)
  assets/                Static files
tests/                   Test suite
codev/                   Development methodology (specs, plans, protocols)

Development

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
cp .env.example .env
docker compose up -d
pytest

Data sources

All Quran text, translations, and tafsir are sourced from Quran Foundation projects, including quran.com and nuqayah.com.

License

QFGPL-1.0 — Quran Foundation General Public License

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides AI assistants with comprehensive access to Islamic resources including Quran verses with translations, Tafsir commentary, Hadith collections, and audio recitations. Enables users to explore Islamic texts, get daily inspiration, and access scholarly interpretations through natural language queries.
      18
      28 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides AI clients with fast, hallucination-free access to the Quran through 13 MCP tools, covering search, navigation, morphology, tafsir, translations, and surah background over stdio and Streamable HTTP.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to retrieve canonical Quran text, translations, scholarly tafsir, full-text search, and word-level morphology from verified Quran data.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Provides read-only access to Quran data — reciters, surahs, full-text search, ayah retrieval, prayer times, live radio stations, and Hijri dates — so AI agents can answer Islamic content queries. Runs locally via stdio or remotely over stateless HTTP for Claude, ChatGPT, and other MCP clients.
      8
      ISC