widequran-mcp 0.1.1

MCP server for WideQuran — query Quran ayahs, surahs, hadith, and tafsir from Claude, Cursor, and Windsurf

widequran-mcp

MCP server for WideQuran — query Quran ayahs, surahs, hadith collections, tafsir commentary, and Quranic figures directly from Claude, Cursor, and Windsurf. Access 114 surahs, 31,240 ayahs, 7,604 hadith, and multiple tafsir traditions through your AI assistant.

Browse the Quran at widequran.com — 114 surahs, 31,240 ayahs across multiple translations, 7,604 hadith from major collections, tafsir commentary, and encyclopedic data on Quranic people and topics.

Table of Contents

• Install
• Configure
  • Claude Desktop
  • Cursor
  • Windsurf
• Available Tools
• Example Conversations
• Quran Data Overview
• Environment Variables
• Also Available
• WideHoly Scripture Platform
• License

Install

pip install widequran-mcp

Or with uvx (no install needed):

uvx widequran-mcp

Configure

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "widequran": {
      "command": "uvx",
      "args": ["widequran-mcp"]
    }
  }
}

Or if installed with pip:

{
  "mcpServers": {
    "widequran": {
      "command": "widequran-mcp"
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "widequran": {
      "command": "uvx",
      "args": ["widequran-mcp"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "widequran": {
      "command": "uvx",
      "args": ["widequran-mcp"]
    }
  }
}

Available Tools

Tool	Description
get_ayah	Get a Quran ayah by surah and ayah number, with Arabic text and translation
search_quran	Search Quran text across all ayahs
get_surah	Get surah information — name, revelation type, ayah count
get_hadith	Get a hadith by collection and number, with grade and narrator
get_tafsir	Get tafsir (exegetical commentary) for a specific ayah
get_person	Get information about a Quranic person or prophet

Example Conversations

Once configured, ask your AI assistant:

• "Show me Surah Al-Fatihah, ayah 1 with the Sahih translation"
• "Search the Quran for ayahs about mercy"
• "Tell me about Surah Yasin — how many ayahs does it have?"
• "Get hadith number 1 from Sahih Bukhari"
• "What does Ibn Kathir say about Surah 2, ayah 255 (Ayat al-Kursi)?"
• "Tell me about the prophet Ibrahim in the Quran"
• "Find Quran verses about patience and perseverance"
• "Get hadith number 25 from Sahih Muslim"

The server calls the WideQuran API and returns structured data including Arabic text, translations, hadith grades, tafsir commentary, and biographical information.

Quran Data Overview

Category	Content
Surahs	114 surahs (86 Meccan, 28 Medinan)
Ayahs	31,240 ayahs across multiple translations (Sahih International, Pickthall, Yusuf Ali)
Hadith	7,604 hadith from Bukhari, Muslim, Tirmidhi, Abu Dawud, and more
Tafsir	Commentary from Ibn Kathir, Al-Jalalayn, Al-Tabari, and others
People	Prophets and figures mentioned in the Quran (Ibrahim, Musa, Isa, Maryam, Yusuf)
Structure	30 juz, 60 hizb, page and ruku markers

Environment Variables

Variable	Default	Description
WIDEQURAN_BASE_URL	https://widequran.com/api/v1/quran	Override API base URL

Also Available

Platform	Install	Link
PyPI	pip install widequran	PyPI

WideHoly Scripture Platform

Site	Domain	Focus
WideBible	widebible.com	Bible — 66 books, 31,102 verses, KJV and modern translations
WideQuran	widequran.com	Quran — 114 surahs, 31,240 ayahs, hadith, tafsir
WideTorah	widetorah.com	Torah — Pentateuch, Talmud, Mishnah, Jewish commentary
WideGita	widegita.com	Bhagavad Gita — 18 chapters, 700 shlokas, Sanskrit and translations
WideSutra	widesutra.com	Buddhist sutras — Pali Canon, Mahayana, Zen texts
WideHoly	wideholy.com	Multi-religion scripture encyclopedia and cross-reference hub

Learn More About the Quran

• Scripture: Surahs · Translations
• Reference: People · Topics · Glossary
• Study: Tafsir · Hadith Collections · Juz Divisions
• Tools: Search · Developer Docs
• API: Developer Docs · OpenAPI Spec

License

MIT License — see LICENSE for details.