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

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

Environment Variables

Also Available

WideHoly Scripture Platform

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.