Loading...

MCP server providing access to the Quran.com API, enabling LLMs to retrieve Quranic verses, translations, and related information.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
MCP server providing access to the Quran.com API, enabling LLMs to retrieve Quranic verses, translations, and related information.
This MCP server is relatively safe due to its read-only nature and reliance on an external API. However, proper API key management is crucial. Enabling verbose mode should be done cautiously to avoid exposing sensitive information.
Performance depends on the Quran.com API. Consider caching frequently accessed data to reduce latency.
Cost depends on the usage of the Quran.com API. Monitor API usage to avoid unexpected costs.
{
"mcpServers": {
"quran-api": {
"command": "docker",
"args": ["run", "-i", "--rm", "--init", "-e", "API_KEY=your_api_key_if_needed", "-e", "VERBOSE_MODE=true", "quran-mcp-server"],
"disabled": false,
"autoApprove": []
}
}
}API_KEYGET /chaptersRetrieves a list of all chapters (Surahs) in the Quran.
Read-only operation, no data modification.
GET /chapters/{id}Retrieves a specific chapter (Surah) by its ID.
Read-only operation, no data modification.
GET /chapters/{chapter_id}/infoRetrieves information about a specific chapter (Surah).
Read-only operation, no data modification.
GET /verses/by_chapter/{chapter_number}Retrieves verses from a specific chapter (Surah) number.
Read-only operation, no data modification.
GET /verses/by_page/{page_number}Retrieves verses from a specific page number in the Quran.
Read-only operation, no data modification.
GET /verses/by_juz/{juz_number}Retrieves verses from a specific Juz (part) number.
Read-only operation, no data modification.
GET /verses/by_hizb/{hizb_number}Retrieves verses from a specific Hizb (quarter) number.
Read-only operation, no data modification.
GET /verses/by_rub/{rub_el_hizb_number}Retrieves verses from a specific Rub el Hizb (eighth) number.
Read-only operation, no data modification.
GET /verses/by_key/{verse_key}Retrieves a specific verse by its unique key.
Read-only operation, no data modification.
GET /verses/randomRetrieves a random verse from the Quran.
Read-only operation, no data modification.
GET /juzsRetrieves a list of all Juzs (parts) in the Quran.
Read-only operation, no data modification.
GET /searchSearches the Quran for specific terms.
Read-only operation, no data modification.
GET /resources/translationsRetrieves a list of available translations of the Quran.
Read-only operation, no data modification.
GET /resources/translations/{translation_id}/infoRetrieves information about a specific translation.
Read-only operation, no data modification.
GET /resources/tafsirsRetrieves a list of available Tafsirs (commentaries) of the Quran.
Read-only operation, no data modification.
GET /resources/tafsirs/{tafsir_id}/infoRetrieves information about a specific Tafsir (commentary).
Read-only operation, no data modification.
GET /quran/tafsirs/{tafsir_id}Retrieves a specific Tafsir (commentary).
Read-only operation, no data modification.
GET /resources/chapter_recitersRetrieves a list of available chapter reciters.
Read-only operation, no data modification.
GET /resources/recitation_stylesRetrieves a list of available recitation styles.
Read-only operation, no data modification.
GET /resources/languagesRetrieves a list of available languages.
Read-only operation, no data modification.
API Key
This MCP server is relatively safe due to its read-only nature and reliance on an external API. However, proper API key management is crucial. Enabling verbose mode should be done cautiously to avoid exposing sensitive information.
The server is read-only, limiting the risk of unintended actions. Sandboxing further enhances safety by isolating the server's execution environment.
Production Tip
Monitor API usage and error logs to identify potential issues and optimize performance.
An API key may be required depending on the Quran.com API's requirements. Check the Quran.com API documentation for details.
Set the `VERBOSE_MODE` environment variable to `true`.
The server will return an error message to the client.
No, this server provides read-only access to the Quran.com API.
You need to use the appropriate API endpoint and specify the translation ID.
Yes, with proper monitoring and API key management, this server can be used in production.
No, rate limiting needs to be implemented separately, potentially using a reverse proxy or middleware.