Connections & Capabilities
Connects To
Capabilities
Quickstart
Config
{
"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": []
}
}
}Exposed MCP Tools (20)
GET /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.
Safety Assessment
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.
- Read-only access to Quranic data.
- No user data modification or deletion.
- API key authentication provides a basic level of access control.
- Verbose mode aids in monitoring and debugging.
- Potential for API key exposure if not handled securely.
- Reliance on the security of the Quran.com API.
- No built-in rate limiting, potentially leading to abuse.
- Verbose mode might expose sensitive data if not configured correctly.
