10554 NW 132nd St, Hialeah Gardens, FL 33018

35 Years of IJA. Celebrating 35 years of faith, community and togetherness.

// MODEL CONTEXT PROTOCOL · GROUNDED SHIA QUR’AN & TAFSIR SERVER

Shia Qur’an & Tafsir MCP

Connect Claude, ChatGPT, Google Antigravity, Cursor, or VS Code directly to all 114 Surahs (6,236 verses), verified Shia translations, Tafseer e Namoona, and Tafseer al-Kauthar—so AI responses cite verbatim Qur’anic Arabic and authentic scholarly commentary instead of paraphrasing from memory.

Connect MCP Server ↓ Open Server Portal ↗
// 01 · OVERVIEW & SERVER ENDPOINT

Get Started with Shia Qur’an & Tafsir MCP

General-purpose AI models often hallucinate verse numbers, conflate Sunni and Shia exegetical sources, or misquote Arabic diacritics. The Shia Qur’an & Tafseer MCP Server gives any Model Context Protocol (MCP) assistant direct, read-only access to verified scripture, classical Arabic root morphology, and authoritative Shia exegesis.

v1.3.0 Current Release
17 Tools 5 Functional Groups
7 Editions Arabic · English · Urdu
6,236 Verses · 114 Surahs
Free No API Key Required
REMOTE STREAMABLE HTTP & SSE ENDPOINT · AUTH: NONE https://quran-shia-mcp.onrender.com/mcp
Server Docs ↗
// 02 · WORKFLOW

Your First Grounded Study Session

Once connected, your AI assistant follows a four-step scholarly grounding flow to ensure every citation is verifiable.

Step 01 · Connect

Register the Remote Endpoint

Add https://quran-shia-mcp.onrender.com/mcp in Claude, ChatGPT Developer Mode, or your IDE’s mcpServers configuration. No API key or OAuth login is required.

Step 02 · Ground

Load Scholarly Grounding Rules

At the start of a session, the model calls fetch_grounding_rules and list_editions so Qur’anic Arabic is quoted verbatim and translations are attributed accurately.

Step 03 · Retrieve

Pull Parallel Translations & Shia Tafsir

Use fetch_tafseer, fetch_quran, or search_tafsir to inspect Ayatollah Makarem Shirazi’s Tafseer e Namoona and Allama Mohsin Ali Najafi’s Tafseer al-Kauthar side by side.

Step 04 · Cross-Examine

Trace Arabic Roots & Ja’fari Rulings

Inspect word-level morphology (fetch_word_morphology), concordance occurrences across all Surahs, and Ja’fari obligatory (wājib) Sajdah metadata (fetch_quran_metadata).

// 03 · CONNECT & ADVANCED SETUP

Connect Your AI Assistant

Choose your client below to connect directly to https://quran-shia-mcp.onrender.com/mcp. Recommended server identifier: quran-shia.

Connect Claude (Web, Desktop & Claude Code)

  1. In Claude.ai or Claude Desktop, open Settings → Connectors → Add custom connector.
  2. Set Name to Shia Quran & Tafseer and Remote MCP server URL to https://quran-shia-mcp.onrender.com/mcp.
  3. Leave authentication blank (None). If Claude displays “Couldn’t determine how this server signs in”, select Continue anyway.
  4. Enable the connector in your chat tools menu, or register it in Claude Code CLI with a single command:
Terminal · Claude Code CLI
claude mcp add --transport http quran-shia https://quran-shia-mcp.onrender.com/mcp
// 04 · INTERACTIVE PLAYGROUND

Live Verse & Shia Tafsir MCP Explorer

Test the fetch_tafseer tool right from your browser against https://quran-shia-mcp.onrender.com/mcp, or click a landmark verse below to inspect its Arabic text, English translation, and Shia commentary.

Ready · Surah 33:33 (Ayat al-Tathir)
Surah Al-Ahzab (33:33) · Ayat al-Tathir Open Surah in Qur’an Reader →

إِنَّمَا يُرِيدُ ٱللَّهُ لِيُذْهِبَ عَنكُمُ ٱلرِّجْسَ أَهْلَ ٱلْبَيْتِ وَيُطَهِّرَكُمْ تَطْهِيرًا

English Translation · Yusuf Ali / M. H. Shakir

“Allah only desires to keep away the uncleanness from you, O People of the House (Ahlulbayt), and to purify you a (thorough) purifying.”

// TAFSEER E NAMOONA · AYATOLLAH MAKAREM SHIRAZI

Exegetical Summary

Highlights the exclusive grammatical shift to the masculine plural pronoun (‘ankum / yutahhirakum) addressing the Five Pure Ones of the Cloak (Hadith al-Kisa): Prophet Muhammad (S.A.W.W.), Imam Ali (A.S.), Sayyida Fatima al-Zahra (S.A.), Imam Hasan (A.S.), and Imam Hussain (A.S.), establishing their divinely safeguarded infallibility (‘ismah).
// TAFSEER AL-KAUTHAR · ALLAMA MOHSIN ALI NAJAFI

Exegetical Summary

Examines the lexical force of ‘innama’ (restriction) and ‘al-rijs’ (every spiritual, moral, and doctrinal impurity), citing convergent Sunni and Shia narrations (Sahih Muslim, Musnad Ahmad, Al-Kafi) confirming revelation concerning the Ahlulbayt (A.S.).
// 05 · STUDY PROMPTS

Example Grounded Prompts

Copy any prompt below into Claude or ChatGPT after enabling the quran-shia connector.

Comparative Shia Exegesis
“Compare Tafseer e Namoona and Tafseer al-Kauthar on Surah Al-Ma’idah 5:55 (Ayat al-Wilayah), quoting the verbatim Arabic text first.”
Root Morphology & Concordance
“Use fetch_word_morphology and fetch_word_concordance to analyze the Arabic root of ‘waliyy’ in 5:55 and show key occurrences across the Qur’an.”
Ahlulbayt (A.S.) Thematic Study
“Retrieve Surah Al-Shura 42:23 (Ayat al-Mawaddah) and Surah Al-Insan 76:5–12 with Shia translations and summarize the commentary strictly from retrieved sources.”
Ja’fari Fiqh & Sajdah Verses
“Call fetch_quran_metadata to list the four obligatory (wajib) Sajdah Surahs in Ja’fari jurisprudence and retrieve the exact Sajdah verses.”
// 06 · API & TOOL CATALOG

Complete 17-Tool Reference

Every tool exposed by https://quran-shia-mcp.onrender.com/mcp, organized across five scholarly capability groups.

01 · Grounding & Session Setup (2 Tools)

fetch_grounding_rules

Returns mandatory citation, verbatim Arabic quoting, and anti-hallucination rules for Qur’anic and Shia exegetical responses.

Params: none (call first in every study session)
list_editions

Lists all 7 available Arabic scripture, English/Urdu translation, and Shia Tafsir editions with scholar attributions.

Params: language? (ar | ur | en), type? (quran | translation | tafsir)

02 · Scripture, Translation & Tafsir Retrieval (8 Tools)

fetch_quran

Retrieves verbatim Tanzil Arabic text for a single verse, verse range, or complete Surah.

Params: surah, ayah?, end_ayah?
search_quran

Full-text search across Arabic scripture with diacritic-insensitive matching and Surah filtering.

Params: query, surah?, limit?
fetch_tafseer

Unified verse bundle returning Arabic, English, Jawadi, Balagh, Namoona translations, plus Tafseer e Namoona and Tafseer al-Kauthar.

Params: surah, ayah, source? (all | namoona | kauthar)
fetch_tafsir

Fetches commentary from a specific Shia Tafsir edition for a verse or contiguous passage.

Params: edition (namoona-tafseer | kauthar), surah, ayah
search_tafsir

Searches across Shia exegetical commentary volumes for theological, historical, or jurisprudential topics.

Params: query, edition?, limit?
fetch_translation

Retrieves one or more parallel Shia translations (Jawadi, Balagh ul Quran, Namoona, or Yusuf Ali / Shakir).

Params: edition, surah, ayah?, end_ayah?
search_translation

Keyword and phrase search across English and Urdu translations with ranked verse hits.

Params: query, edition?, limit?
search_verses

Combined multi-field search spanning Arabic text and parallel translations simultaneously.

Params: query, surah?, limit?

03 · Classical Arabic Word Study & Morphology (3 Tools)

fetch_word_morphology

Word-by-word grammatical breakdown (lemma, trilateral root, part of speech, case/mood, and clitics) for any verse.

Params: surah, ayah, word_index?
fetch_word_paradigm

Displays verbal form patterns (Forms I–X) and morphological inflections attested for a Qur’anic root.

Params: root | lemma
fetch_word_concordance

Lists every Qur’anic verse where a given trilateral Arabic root or lemma appears with contextual snippets.

Params: root, limit?

04 · Interactive Study & Deep Links (2 Tools)

interactive_study

Generates a structured multi-panel study view pairing Arabic, morphology, parallel translations, and Shia Tafsir.

Params: surah, ayah
resolve_reader_link

Produces canonical shareable web reader URLs for any Surah, verse, or verse range.

Params: surah, ayah?

05 · Qur’anic Metadata & Ja’fari Utilities (2 Tools)

fetch_quran_metadata

Returns Juz’, Hizb, Ruku’, revelation order, and Ja’fari obligatory (wājib) Sajdah rulings (32:15, 41:37–38, 53:62, 96:19).

Params: surah?
list_surahs

Complete directory of all 114 Surahs with Arabic titles, English names, revelation place (Makki / Madani), and verse counts.

Params: revelation_type?
// 07 · PRIMARY CORPORA

Supported Editions & Scholarly Sources

Seven curated editions spanning verbatim Arabic scripture, English translation, and landmark Shia Urdu/English translations and commentaries.

Edition Key Title & Scholar Language Category
quran-simple Tanzil Qur’an Text (Simple v1.1) — Tanzil.net Project (CC BY 3.0 Verbatim) Arabic (ar) Verbatim Scripture
en.yusufali-shakir English Translation — Abdullah Yusuf Ali & M. H. Shakir English (en) Translation
jawadi Tarjuma Allama Syed Zeeshan Haider Jawadi — Classical Shia Urdu translation Urdu (ur) Translation
balagh Balagh ul Quran — Allama Sheikh Mohsin Ali Najafi Urdu (ur) Translation & Hawashi
namoona Tarjuma Tafseer e Namoona — Maulana Syed Safdar Hussain Najafi Urdu (ur) Translation
namoona-tafseer Tafseer e Namoona — Grand Ayatollah Naser Makarem Shirazi & Hawza Scholars Urdu / English Full Shia Exegesis
kauthar Tafseer al-Kauthar — Allama Sheikh Mohsin Ali Najafi Urdu (ur) Full Shia Exegesis
// 08 · OPERATIONAL NOTES

Troubleshooting & Scholarly Grounding Notes

Initial Cold-Start Wake Time (~20s): The public server at https://quran-shia-mcp.onrender.com/mcp runs on Render. If no study session has been active in the last 15 minutes, the very first request wakes the container in ~20–30 seconds; all subsequent tool calls complete in milliseconds.
Zero Authentication / Public Access: Leave API Key, Bearer Token, and OAuth Client ID fields empty (Auth: None). If Claude Desktop asks whether to proceed without OAuth discovery, click Continue anyway.
Scholarly Verification Reminder: AI summaries assist study and cross-referencing but do not replace traditional religious scholarship. For binding Ja’fari fiqh rulings or pastoral counsel, consult Resident Aalim Maulana Jaffer Banglori or the office of your Marja’.
Resident Aalim →