Lets agents search verses and get translations and tafsir through the Quran.com API.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add quran --env API_KEY='<API_KEY>' --env VERBOSE_MODE='<VERBOSE_MODE>' -- docker run -i --rm --init -e 'API_KEY={{config.API_KEY}}' -e 'VERBOSE_MODE={{config.VERBOSE_MODE}}' quran-mcp-server~/.codex/config.toml
[mcp_servers.quran]
command = "docker"
args = ["run", "-i", "--rm", "--init", "-e", "API_KEY={{config.API_KEY}}", "-e", "VERBOSE_MODE={{config.VERBOSE_MODE}}", "quran-mcp-server"]
env = { API_KEY = "<API_KEY>", VERBOSE_MODE = "<VERBOSE_MODE>" }
# codex mcp add quran --env API_KEY='<API_KEY>' --env VERBOSE_MODE='<VERBOSE_MODE>' -- docker run -i --rm --init -e 'API_KEY={{config.API_KEY}}' -e 'VERBOSE_MODE={{config.VERBOSE_MODE}}' quran-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"quran": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}Environment variables
API_KEYVERBOSE_MODE
Replace the placeholders with your own credentials and keep them out of version control.