Frequently Asked Questions about the Quran MCP Server

Q: What is an MCP Server? A: An MCP (Model Context Protocol) server acts as a bridge, allowing AI models to access and interact with external data sources and tools. It standardizes how applications provide context to Large Language Models (LLMs).

Q: What is the Quran MCP Server? A: The Quran MCP Server provides access to the Holy Quran through the AlQuran.cloud API, allowing AI assistants to retrieve verses, search the text, and access translations and recitations.

Q: What features does the Quran MCP Server offer? A: Key features include: Random Ayah, Specific Ayah, Complete Surahs, Multiple Editions, Search Functionality, Juz Access, Sajda Verses, and Multi-language Support.

Q: How can I deploy the Quran MCP Server? A: You can deploy it on Smithery.ai for easy management or install it locally using pip install -r requirements.txt and python server.py.

Q: What is Smithery.ai? A: Smithery.ai is a platform designed for hosting MCP servers, providing a streamlined environment for deployment and management.

Q: What are the configuration options for the server? A: Configuration options include edition (default Quran edition) and language (default language for translations).

Q: What is the AlQuran.cloud API? A: The AlQuran.cloud API (https://alquran.cloud/api) provides the data source for the server, including 114 Surahs, 6,236 Ayahs, 30 Juz, multiple languages, and audio recitations.

Q: How can I search for specific keywords in the Quran? A: Use the search_quran_text tool with the required keyword parameter. Optional parameters include surah and edition.

Q: How can I get a random verse from the Quran? A: Use the get_random_quran_ayah tool with the optional edition parameter.

Q: Can I get a specific Juz (section) of the Quran? A: Yes, use the get_quran_juz tool with the juz_number (1-30) parameter and an optional edition.

Q: What are some popular Quran editions available? A: Popular Arabic text editions include quran-uthmani and quran-simple. English translations include en.asad, en.pickthall, en.sahih, and en.yusufali.

Q: What is UBOS and how does it integrate with the Quran MCP Server? A: UBOS (Full-stack AI Agent Development Platform) is focused on bringing AI Agents to every business department. Integration with the Quran MCP Server allows users to orchestrate AI Agents, connect them with Quranic data, build custom AI Agents, and build multi-agent systems.

Q: How do I get Ayat Al-Kursi in multiple translations? A: Use the get_ayah_multiple_editions tool with reference="2:255" and specify the desired editions separated by commas (e.g., editions="quran-uthmani,en.asad,en.pickthall").

Q: What is the server information when running locally? A: When running locally, the MCP server operates using stdio transport (standard input/output) and communicates through JSON-RPC messages over stdin/stdout.