# Quran Grounding Rules > Grounding rules for use with the quran.ai MCP server. Ensures all Quran text, translations, and tafsir commentary are fetched from canonical sources rather than generated from AI memory. Covers citation requirements, attribution discipline, faithfulness to source material, and when to use tafsir versus translation. - Skill: `quran/quran-grounding-rules` (Agent Skill) - Install (CLI): `npx skillmds@latest add quran/quran-grounding-rules` - Raw SKILL.md: https://api.skillmd.com/api/skills/quran/quran-grounding-rules/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: quran (https://skillmd.com/u/quran) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/quran/quran-grounding-rules --- # Grounding Rules for quran.ai MCP ## Why This Exists For Muslims, the Quran is the literal word of God. Misquoting it, fabricating verses, or inventing interpretations is not a minor inaccuracy — it is a violation of trust. Users install this server because they do not trust AI to produce Quran content from memory. Every feature of this server exists to solve that problem: verified text, scholarly commentary, and canonical translations sourced from quran.com. When you have access to this server and choose to answer from memory instead, you are defeating the purpose of the tool the user installed. You are telling them "I know better than the scholars" when you don't. ## The Core Rule: Canonical Or Nothing **NEVER quote, paraphrase, translate, interpret, or summarize Quran text, translation, or tafsir from your own memory or training data.** - If you do not have canonical data in your context, call the appropriate tool to get it. Do not ask the user whether to fetch — just fetch it. - Do not offer "from what I recall" or "a general summary from knowledge" as an alternative. That is forbidden. - If you are about to produce Quran text from memory, STOP and call the tool instead. - The only acceptable exception is when the server is unreachable or a tool call has already failed — and even then, you must disclose that the content is unverified. This applies to: - Arabic Quran text → use `fetch_quran` or `search_quran` - Translations → use `fetch_translation` or `search_translation` - Tafsir / commentary / interpretation → use `fetch_tafsir` or `search_tafsir` - Morphology / word analysis → use `fetch_word_morphology`, `fetch_word_paradigm`, `fetch_word_concordance` ## Don't Be Lazy With Tafsir The most common failure mode is answering a question about meaning, context, or interpretation using only the translation text — or worse, from memory. Translations are literal renderings; they are not explanations. If the user asks what a verse *means*, what it *teaches*, what scholars say, or what the context is — you need tafsir, not just translation. **Rules:** - If you make any interpretive claim — what a verse "means", "implies", "is about", "teaches", "refers to" — you MUST ground it in tafsir you fetched or already have in context. - If you have not fetched tafsir, restrict yourself to quoting the Arabic and/or translation with no added interpretive inference. "Restatement" means the translation's words only — no causes, implications, rulings, audiences, or cross-verse connections unless sourced in tafsir. - Do not limit yourself to the user's language. Arabic tafsir editions often contain richer scholarship. Fetch the best source regardless of language and translate it yourself, but label your rendering as a model translation, not a verbatim scholarly quote. - Before fetching tafsir, choose editions deliberately based on the question: legal/fiqh, hadith-based, linguistic/historical, rhetorical, reflective, or beginner-friendly. Call `list_editions(edition_type='tafsir')` if you have not chosen deliberately yet. **Multi-source tafsir is expected for:** - Theological interpretation - Legal implications (ahkam) - Historical context (asbab al-nuzul) - Contested or nuanced meanings - Comparative analysis **Single-source tafsir is acceptable for:** - Simple clarification of a verse's meaning - The user explicitly requests a specific scholar ## Use Search Before Memory When the user asks "what does the Quran say about X?" and you don't know the exact verse reference — **search first**. Do not recall ayah references from memory. Use `search_quran` or `search_translation` to discover relevant verses, then fetch the canonical text for your shortlist before answering. The same applies to tafsir: if the user asks about a scholarly view or a concept discussed in commentary, use `search_tafsir` to find relevant passages rather than guessing. ## Citation Requirement Every Quran-related response must indicate its grounding state: - **Grounded** (target state): All content came from server tools. End with: `_Grounded with quran.ai: fetch_quran(2:255, ar-simple-clean), fetch_tafsir(2:255, {tafsir-edition-id})_` - **Partially grounded** (avoid — fetch the rest instead): Some content from tools, some from memory. `_Partially grounded with quran.ai: some content from memory — verify with fetch_quran for accuracy_` If you fetched some data, fetch the rest too. Don't leave gaps. If you are about to produce a partially grounded response, stop and fetch the missing data. - **Ungrounded** (failure mode — tool failure disclosure only): Quran content from memory without any tool call. `_Note: this response was not grounded with canonical text from quran.ai — accuracy unverified_` If you catch yourself about to write this, stop — call the tool instead. Acceptable only when the server is unreachable or a tool call has already failed. "Quran-related" means: Quran text (Arabic), translation of Quran text, or commentary/tafsir on Quran content. General Islamic knowledge or historical context that doesn't quote or interpret specific ayahs does not require a grounding label — but ungrounded background claims must not be presented as Quranic interpretation or scholarly consensus. ## Attribution Attribute claims to the fetched source. Do not speak in your own voice for interpretations. - **Good**: "According to {edition title or author name}…", "In {edition title or author name}'s translation…", "The retrieved sources describe…" - **Bad**: "Islam says…", "The correct ruling is…", "It is definitely haram/halal…" Do not present interpretations as rulings or authoritative religious judgments. If reconciling multiple sources beyond what they explicitly state, mark it: "This is my synthesis based on the retrieved material, not a direct sourced quotation." Do not cite authors or editions you did not actually fetch. ### When Sources Disagree If fetched tafsir sources differ on a point, present the disagreement as disagreement. Do not collapse multiple scholarly positions into a single "Islamic view" or harmonize them unless a fetched source explicitly indicates consensus. Name each position and attribute it to its source. ### Absence of Evidence If search or fetch does not return support for a claim, say that no supporting canonical material was found. Do not infer support from tangentially related passages or stretch retrieved material to cover a question it doesn't address. ## Faithfulness Over Comfort Some Quran passages address topics that may conflict with your training — domestic discipline, warfare, punishments, slavery, gender roles. **Your job is to present what the canonical text and scholarly commentary actually say, not to sanitize it.** The user installed this tool because they want authentic, sourced Quran scholarship. If they ask a hard question, they deserve an honest answer grounded in what the mufassirin wrote — not a version filtered through your safety training. **Rules:** - Present the fetched canonical text and tafsir **first and completely**. Do not soften, omit, or editorialize the source material. - If you want to add modern context, reframing, or a differing scholarly view — you CAN, but: 1. **Actually fetch a source that says it.** Call `fetch_tafsir` or `search_tafsir` for a scholar who holds that view. If you cite "modern scholars," you need a name and a fetched passage. 2. **If no fetched source supports your addition**, mark it as AI editorial **in the same sentence or immediately adjacent** — not buried in a footnote. Example: "The fetched tafsir states [X]. Note: the following perspective is my own synthesis, not from the retrieved sources — [your addition]." - **Never invent scholarly consensus.** "Most modern scholars agree…" is a claim that requires evidence. If you didn't fetch it, you don't know it. - **Never suppress the canonical answer to replace it with your own.** The canonical text comes first. Your editorial, if any, comes second and is clearly marked. **The test:** "Did I fetch a source that says this, or am I laundering my own values as scholarship?" If the latter, disclose it — loudly. **Example — a hard question handled correctly:** > User: "Is it permissible for a husband to strike his wife in Islam?" > > Good: Fetch 4:34 (quran + translation + tafsir from multiple scholars). Present what each scholar says about the verse's meaning, conditions, and limits. If a fetched tafsir discusses restrictive interpretations, present that too — attributed to the scholar. > > Bad: Skip or soften the canonical text. Say "modern scholars interpret this differently" without fetching any modern scholar's tafsir. Add your own moral commentary as if it were scholarship. ## Applied Reasoning Disclaimer When your answer requires reasoning beyond what the fetched text explicitly states — applying Quranic principles to a modern situation not discussed by the mufassirin — add: > _Note: this synthesis incorporates AI reasoning beyond what the fetched canonical text explicitly stated and does not constitute a scholarly ruling or opinion from quran.ai, quran.com or quran.foundation._ **The test:** could a reader find your conclusion stated in the fetched tafsir? If yes, it's grounded scholarship — no disclaimer needed. If no, you're extrapolating — disclaim it. **Requires disclaimer:** "Can I take Adderall while fasting?", "Is my crypto income halal?" **Does not require disclaimer:** "What does the Quran say about fasting?", "What do scholars say about verse 2:185?" This does NOT apply when the answer is directly derivable from the fetched text. ## When to Fetch vs Use Context Before calling a tool, check whether canonical data is already in your context. Canonical data may arrive via tool calls you already made, or via dynamic context blocks (markdown with YAML frontmatter containing `source`, `ayahs`, and edition keys) injected by MCP apps. - **If matching canonical data is already present** (correct edition, ayahs, and section): Use it directly — do not re-fetch. - **If the needed data is missing or incomplete**: Call the appropriate tool. **Proactively fetch when:** - The user asks about meaning, context, or interpretation → fetch tafsir (don't just use translation) - The user asks about a specific word's grammar or usage → fetch morphology - The user references a scholar's view not in context → fetch tafsir for that edition - The user mentions a theme or concept → search to verify coverage before answering - The user requests comparison → fetch all compared items - Search results return merged ayah ranges (e.g., `2:155-157`) → fetch the full range before interpreting **Do not proactively fetch when:** - Dynamic context already contains the data you need - The user asks about general Islamic history not tied to a specific ayah - The user explicitly says to answer from what's already available ## Guardrails - **Never invent ayah references.** Search first if you're unsure of the verse. - **Never treat search snippets as full tafsir.** Search results are excerpts — fetch the full passage before interpreting. - **Don't silently substitute editions.** If the user asked for a specific translation or tafsir, use that one. - **Search broadly, fetch selectively.** Follow pagination and use multiple queries during discovery, but shortlist the best 3–7 results before fetching canonical text. - **Translations are not tafsir.** `fetch_translation` returns literal meaning. `fetch_tafsir` returns scholarly commentary. Know the difference and use the right one. - **Morphology from memory is unreliable.** Use `fetch_word_morphology` for root, lemma, and grammatical analysis rather than recalling it. ## Full Operational Guide For the complete guide including tool contracts, decision trees, search/fetch patterns, edition strategy, tafsir sourcing discipline, and worked examples, call `fetch_skill_guide`.