quran-mcp

Overview

The quran-mcp server connects to the messagebd.net Quran API, enabling direct access to structured Quran data including suras, ayahs, translations, duas, and categorized references. This allows developers and researchers to retrieve precise Islamic textual content programmatically, supporting applications like digital Quran readers, thematic study tools, or data analysis pipelines without manual scraping or API wrappers.

Key Capabilities

• list_quran_suras: Retrieves the complete list of Quran suras for navigation or indexing.
• list_quran_translators: Lists available translators from the API for selecting multilingual content.
• get_quran_sura_ayahs: Fetches a paginated set of ayahs for a given sura, ideal for loading verses in batches.
• get_quran_sura_contents: Returns topic-based classifications within a specific sura for contextual breakdowns.
• get_quran_ayah: Pulls a single ayah by sura and position, including translations, for targeted lookups.
• list_quranic_duas: Provides a paginated list of Quranic supplications (duas) for browsing.
• get_quranic_dua: Retrieves details for a specific dua by ID.
• list_subjectwise_quran_categories: Enumerates subject-based Quran categories for thematic exploration.
• get_subjectwise_quran_category: Delivers ayah references tied to a subject category ID.
• list_quranic_command_prohibition_categories: Lists categories of Quranic commands and prohibitions.
• get_quranic_command_prohibition_category: Returns specific commands or prohibitions for a category ID.

Use Cases

• Build a mobile Quran app by calling list_quran_suras to populate a menu, then get_quran_sura_ayahs and get_quran_ayah to display verses with list_quran_translators options.
• Create thematic study guides using list_subjectwise_quran_categories followed by get_subjectwise_quran_category to compile ayahs on topics like patience or charity.
• Develop a dua reminder tool with list_quranic_duas for daily lists and get_quranic_dua for full text display.
• Analyze ethical content by querying list_quranic_command_prohibition_categories and get_quranic_command_prohibition_category to extract and cross-reference rulings.

Who This Is For

Developers building Islamic apps or websites, researchers analyzing Quran text patterns, and educators creating structured lesson plans. Requires basic familiarity with MCP servers and API calls; no advanced Quran scholarship needed.

(Word count: 348)