quran-mcp-server

MCP server to interact with Quran.com corpus via the official REST API v4.

This is a Model Context Protocol (MCP) server generated from the OpenAPI specification.

The following endpoints from the API have been made available as tools, that LLMs can use via compatible clients.

• GET /chapters - List Chapters
• GET /chapters/{id} - Get Chapter
• GET /chapters/{chapter_id}/info - Get Chapter Info

• GET /verses/by_chapter/{chapter_number} - Get verses by Chapter / Surah number
• GET /verses/by_page/{page_number} - Get all verses of a specific Madani Mushaf page
• GET /verses/by_juz/{juz_number} - Get verses by Juz number
• GET /verses/by_hizb/{hizb_number} - Get verses by Hizb number
• GET /verses/by_rub/{rub_el_hizb_number} - Get verses by Rub el Hizb number
• GET /verses/by_key/{verse_key} - Get verse by key
• GET /verses/random - Get a random verse

• GET /juzs - Get list of all juzs

• GET /search - Search the Quran for specific terms

• GET /resources/translations - Get list of available translations
• GET /resources/translations/{translation_id}/info - Get information of a specific translation

• GET /resources/tafsirs - Get list of available tafsirs
• GET /resources/tafsirs/{tafsir_id}/info - Get the information of a specific tafsir
• GET /quran/tafsirs/{tafsir_id} - Get a single tafsir

• GET /resources/chapter_reciters - List of Chapter Reciters
• GET /resources/recitation_styles - Get the available recitation styles

• GET /resources/languages - Get all languages

• Node.js 22+
• Docker

Before using the Docker-based production mode, you need to build the Docker image:

# Build the Docker image
docker build -t quran-mcp-server .