Use MCP to access Quran text, audio, narration differences, and mushaf structure in your apps.

📖 QuranHub MCP Server

The QuranHub MCP Server provides a rich set of tools for accessing and exploring the Quran programmatically.
You can use these tools inside Cursor or any other MCP-compatible client.

⚙️ Setup

Add the server to your MCP configuration file:

{
  "servers": {
    "quranhub": {
      "type": "http",
      "url": "https://api.qurani.ai/gw/mcp"
    }
  }
}

🕌 Core Quran Tools

Essential tools for retrieving Quran content by structure.

Tool	Description	Example Input
`get_complete_quran`	Get the entire Quran in default edition	(no input)
`get_complete_quran_by_edition`	Get complete Quran in specific edition	`"quran-uthmani"`
`get_surah`	Get a complete Surah with all verses	`2` (Al-Baqarah)
`get_surah_by_edition`	Get Surah in specific edition	`surah: 1, edition: "en.sahih"`
`get_surah_by_multiple_editions`	Get Surah in multiple editions	`surah: 1, editions: "quran-uthmani,en.sahih"`
`get_ayah`	Get a specific verse by reference	`"2:255"`
`get_ayah_by_edition`	Get ayah in specific edition	`ref: "2:255", edition: "en.sahih"`
`get_ayah_by_multiple_editions`	Get ayah in multiple editions	`ref: "2:255", editions: "quran-uthmani,en.sahih"`
`get_juz`	Get a complete Juz (1-30)	`3`
`get_juz_by_edition`	Get Juz in specific edition	`juz: 1, edition: "en.sahih"`
`get_page`	Get a specific Quran page (1-604)	`255`
`get_page_by_edition`	Get page in specific edition	`page: 1, edition: "quran-uthmani"`
`get_hizb`	Get a Hizb section (1-60)	`15`
`get_hizb_by_edition`	Get Hizb in specific edition	`hizb: 1, edition: "quran-uthmani"`
`get_hizb_quarter`	Get Hizb Quarter (1-240)	`120`
`get_hizb_quarter_by_edition`	Get Hizb Quarter in specific edition	`quarter: 1, edition: "quran-uthmani"`
`get_manzil`	Get a Manzil for weekly reading (1-7)	`5`
`get_manzil_by_edition`	Get Manzil in specific edition	`manzil: 1, edition: "quran-uthmani"`
`get_ruku`	Get a Ruku section	`40`
`get_ruku_by_edition`	Get Ruku in specific edition	`ruku: 1, edition: "quran-uthmani"`

🔍 Search & Discovery

Tools to search, explore, and discover Quranic content.

Tool	Description	Example Input
`search_quran`	Search Arabic text and translations	`"mercy"`
`get_random_ayah`	Get a random verse	(no input)
`get_random_ayah_by_edition`	Random verse in specific edition	`"en.sahih"`
`get_random_ayah_by_multiple_editions`	Random verse in multiple editions	`"quran-uthmani,en.sahih"`
`get_similar_ayahs_hafs`	Find verses similar to given ayah (Hafs)	`surah: 1, ayah: 1`
`get_similar_ayahs_by_edition`	Find similar verses by edition	`surah: 1, ayah: 1, edition: "quran-uthmani"`
`get_mutashabihat_phrases_hafs`	Find similar phrases (Hafs)	`surah: 2, ayah: 255`
`get_mutashabihat_phrases_by_edition`	Find similar phrases by edition	`surah: 2, ayah: 255, edition: "quran-uthmani"`
`get_ayah_themes`	List all available themes	(no input)
`get_themes_for_ayah`	Get themes for specific ayah	`surah: 1, ayah: 1`

📚 Editions & Translations

Manage and retrieve different Quran editions, translations, and formats.

Tool	Description	Example Input
`get_all_editions`	List all editions with filters	`language: "en", type: "translation"`
`get_all_languages`	Get all supported languages	(no input)
`get_editions_by_language`	Editions by language	`"ar"` or `"en"`
`get_all_types`	Get edition types	(no input)
`get_editions_by_type`	Editions by type	`"translation"`
`get_all_formats`	Get edition formats	(no input)
`get_editions_by_format`	Editions by format	`"audio"` or `"text"`
`get_editions_by_format_and_type`	Editions by format and type	`format: "text", type: "narration"`
`get_editions_analysis`	Statistical overview of editions	(no input)

🎵 Audio & Recitation

Access audio recitations and reciter information.

Tool	Description	Example Input
`get_distinct_audio_editions`	List unique audio reciters	(no input)
`get_all_narrator_identifiers`	Get all reciter identifiers	(no input)
`get_audio_editions_by_narrator`	Audio by specific reciter	`"quran-warsh"`

📖 Special Features

Advanced features for studying and understanding the Quran.

Tool	Description	Example Input
`get_tajweed_rules`	Tajweed rules for specific words	`"1:1:2"`
`get_word_line_number`	Line number for word location	`"1:1:2"`
`get_word_image`	Word-by-word images	`location: "1:1:2", type: "v4"`
`get_all_sajdas`	Get all prostration verses	(no input)
`get_sajdas_by_edition`	Sajda verses in specific edition	`"quran-uthmani"`
`get_narrations_differences`	Compare different narrations	`page: 1, source: "hafs", target: "warsh"`

📊 Metadata & Structure

Organizational and structural information about the Quran.

Tool	Description	Example Input
`get_quran_metadata`	Complete Quran structure metadata	(no input)
`get_all_surahs`	List all 114 Surahs with details	`revelationOrder: false`
`get_surahs_by_revelation_city`	Surahs grouped by Meccan/Medinan	(no input)
`get_surahs_by_juz`	Surahs organized by Juz	(no input)
`get_all_pages_metadata`	Metadata for all 604 pages	(no input)
`get_pages_metadata_by_edition`	Page metadata for specific edition	`"quran-uthmani"`
`get_all_juzs_metadata`	Metadata for all 30 Juz	(no input)
`get_juzs_metadata_by_edition`	Juz metadata for specific edition	`"quran-uthmani"`
`get_all_hizbs_metadata`	Metadata for all 60 Hizbs	(no input)
`get_hizbs_metadata_by_edition`	Hizb metadata for specific edition	`"quran-uthmani"`

🖋️ Typography & Display

Font resources and page layout information.

Tool	Description	Example Input
`get_font_kinds`	List all font kinds	(no input)
`get_font_formats`	List all font formats	(no input)
`get_font_archives`	List all font archive types	(no input)
`get_font_categories`	List all font categories	(no input)
`get_font_detail`	Get specific font details	`"uthmani"`
`get_font_files`	List font files for download	`fontCode: "uthmani"`
`get_font_page_files`	Get font files for specific page	`font: "uthmani", page: 1`
`list_font_page_files`	List paginated font files	`font: "uthmani", format: "ttf"`

📐 Mushaf Layouts

Page layout and line structure information.

Tool	Description	Example Input
`list_mushaf_layouts`	List mushaf page layouts	`linesPerPage: 15`
`get_layout_detail`	Specific layout information	`"hafs_15"`
`get_layout_page_lines`	Line structure for pages	`layout: "hafs_15", page: 1`
`get_layout_surah_lines`	Line structure for surah	`layout: "hafs_15", surah: 1`
`layout_word_lookup`	Find page/line by word position	`layout: "hafs_15", from: 1, to: 7`

🔧 Utility Functions

Basic utility and test functions.

Tool	Description	Example Input
`get_response`	Basic API response test	(no input)

MCP Server — Quran Tools for Agents & IDEs