quran-search-engine-mcp — Claude Code MCP server: setup guide
Connects verified Quranic records to AI agents using 8 search and morphology tools. Prevents model hallucinations by retrieving literal verse data.
claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcpWhat quran-search-engine-mcp does
This server connects an AI client directly to a verified Quran database. Instead of letting language models invent verses, requests pass to an engine that returns exact Quranic text. The bundle delivers 8 distinct tools covering verse navigation, full-text queries, surah metadata, and Arabic word morphology with root lookups.
Integration works over stdio for local environments and Streamable HTTP for remote instances. Anyone can query the public endpoint at https://mcp.quran.us.kg/ without an API key or account token. Running the server locally via npx strictly requires Node.js 20 or newer. You can also spin up an instance with Docker using docker compose up --build on port 4000.
What it helps with
- locate Quranic verses by keywords or phrases
- analyze Arabic word roots and morphological parts
- pull verified surah metadata and verse text
- prevent AI hallucinations when quoting sacred scripture
Example prompts for the agent
- Find verses addressing patience and return the Arabic text.
- Retrieve metadata for Surah Al-Baqarah along with its opening verses.
- Inspect the morphological breakdown of the opening word in Surah Al-Fatiha.
How to install quran-search-engine-mcp
Platform CLI
claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcpPlatform CLI
codex mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcpConfig file
{
"mcpServers": {
"quran-search-engine-mcp": {
"command": "npx",
"args": [
"-y",
"quran-search-engine-mcp"
]
}
}
}Config file
{
"servers": {
"quran-search-engine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"quran-search-engine-mcp"
]
}
}
}Platform CLI
gemini mcp add quran-search-engine-mcp npx -y quran-search-engine-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about quran-search-engine-mcp
How to install quran-search-engine-mcp in Claude Code?
Run claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp in your terminal.
What does quran-search-engine-mcp do?
It adds 8 tools to your agent for reading surah data, searching verses, and inspecting Arabic morphology. Answers come directly from verified records rather than model memory.
Does the public endpoint require an API key?
No, the hosted endpoint at https://mcp.quran.us.kg/ requires no authentication. If you run the package locally with npx, Node.js 20 or newer must be installed on your system.
