AskSakina Islamic Knowledge

AskSakina Islamic Knowledge MCP Server

Specialist-AI-reviewed Islamic knowledge for AI agents. Quranic verses, a curated du'a corpus, and the 99 Names of Allah — reviewed across the four mainstream Sunni schools (Hanafi, Maliki, Shafi'i, Hanbali) through AskSakina's structured specialist-AI review chain, which is not a substitute for a qualified scholar. Every response is wrapped in a presentation contract so agents cannot silently misrepresent the content.

Architectural posture: *"AskSakina ships records, agents ship answers."* The server is a reference library, not an advisor. Each response includes a _sakina_meta envelope with disclaimer, LLM directives, presentation contract, and educational context. What the calling agent does with the record is its responsibility: every response carries explicit instructions for handling it, but the server cannot make another AI follow them.

---

What it provides

Four lookup tools, four learning-journey prompts and seven resources over the Model Context Protocol. Every record is sourced from AskSakina's main app (asksakina.com), so each MCP release matches what the public app surfaced when it was built.

---

Tools

get_quran_verse

Verbatim Quranic verse lookup by surah:ayah. Returns the canonical AskSakina envelope with Arabic text, translation, surah name (Arabic + English), and the quran presentation contract, which instructs the agent not to paraphrase, to cite surah:ayah, and to label the translation "Translation of the Meaning".

Parameters

Example response (truncated)

{

"_sakina_meta": { "version": "1.0", "content_type": "quran_verse", "presentation_contract": { "quran": { "no_paraphrase": true, "require_citation": "surah:ayah", "translation_label": "Translation of the Meaning" } } /* … */ }, "content": { "surah": { "number": 2, "name_arabic": "البقرة", "name_english": "Al-Baqarah" }, "ayah": 186, "arabic": "وَإِذَا سَأَلَكَ عِبَادِي عَنِّي فَإِنِّي قَرِيبٌ ۖ …", "translation": "And when My servants ask you concerning Me — indeed I am near. …" } }

get_dua

Returns du'as matching a life context (anxiety, grief, morning, travel, etc.). Context is resolved against canonical category slugs, an alias map, and tag dimensions. A natural phrase ("grief after losing my mother") also resolves: the server normalises it and matches known category, alias, tag and synonym words and a few multi-word phrases inside it, deterministically and without AI. content.matched_by says how it resolved. Grief (WO#386): a query that names the querier's own grief ("I lost my mother", "grief after losing my mother", "my father passed away", "bereaved") resolves to context bereaved; a funeral rite or the person who has died ("funeral", "dua for the deceased", "visiting my mother's grave") stays deceased. Parents (WO#430): a query that names a parent (mother, mum, mom, father, dad, parent, parents) together with a death word (late, dead, passed, grave, burial, janaza, janazah, cemetery, funeral, died, death, deceased, lost) takes this grief route and never returns mothers or fathers; "miss" with a parent and no death word returns only the du'as that suit a living or a deceased parent; a plain parent query ("my mother", "parents") is unchanged. A death word on its own, such as "grave", resolves to nothing. bereaved returns seven du'as ruled by the fiqh reviewer (Gem 4), in its order, with a teaching_note on the masculine forms in the Arabic, and always carries at least the soft support note. Crisis detection runs first, on the full raw input. Self-harm and abuse get separate blocks (crisis_type): the abuse block carries domestic-abuse lines and an abuse-specific directive. On any hard crisis (self-harm or abuse) no du'as are returned: content_type is crisis_resource_only and the crisis resource is the whole response. Each block lists 24/7 lines first and states the hours of any limited-hours line. If the context contains a crisis keyword (matched against the main app's `detectCrisis` keyword list), the response includes a mandatory `crisis_resource` block with the appropriate hotline and prosocial directive.

Parameters

Result shaping (2.2.0). A context lookup returns limit records of the route's existing order (bundle order; Gem 4's fixed order on bereaved), starting at offset. When more follow the page, content.total_available gives the whole count, content.truncated is true, and content.more carries the note "N more du'as for this context; call get_dua with offset and limit to see them." The same note is in CRITICAL_RULES. content.offset is present when it is not 0. Every record of a category is reachable by paging.

Example response (truncated)

{

"_sakina_meta": { "content_type": "dua_collection", "presentation_contract": { "hadith": { "require_grading": "per_record" /* true when every record is graded */ } } /* … */ }, "content": { "context": "stress-anxiety", "duas": [ { "dua_block": "Arabic: …\nTransliteration: …\nTranslation: …\nOrigin: Quran 21:87\nSource: Quran 21:87\nGrading: Quranic", "title": "Dua to Deal with Distress & Depression", "arabic": "وَذَا ٱلنُّونِ إِذ ذَّهَبَ …", "source": "Quran 21:87", "grading": "Quranic", "grading_status": "quranic", "origin": "quran", "quran_citation": "Quran 21:87" }, { "title": "Dua to Remove Sorrow & Grief:", "source": "Source not recorded in AskSakina corpus", "grading": "Not graded in AskSakina corpus", "grading_status": "not_recorded" /* … */ } /* … */ ], "total_results": 3, "total_available": 12, "truncated": true, "more": "9 more du'as for this context; call get_dua with offset and limit to see them.", "grading_summary": { "quranic": 2, "graded": 0, "not_a_narration": 0, "not_recorded": 1 } } // crisis_resource block added if context triggers the crisis keyword list }

Grading status. Every du'a record carries grading_status: quranic (the text is a Quranic verse or clause), graded (a hadith grading is recorded), not_a_narration (a general supplication, not a narration from the Prophet; it carries a grading_directive saying so), or not_recorded (the AskSakina corpus holds no grading for it). Most of the corpus is not_recorded today; the Source and Grading lines say so rather than implying a grading exists. Du'as whose Quranic reference has been verified carry origin: "quran" and a quran_citation, and their Arabic is the Tanzil Uthmani text resolved from AskSakina's scripture module at bundle time.

get_name_of_allah

Look up by number (1–99) or string (transliteration, Arabic, or English meaning). Returns Arabic, transliteration, locale-aware meaning, reflection, and Quranic references.

Parameters — one of:

Plus optional locale (tr returns the English meaning and reflection).

Example response (truncated)

{

"_sakina_meta": { "content_type": "name_of_allah" /* … */ }, "content": { "number": 29, "arabic": "الحَكَم", "transliteration": "Al-Hakam", "meaning": "The Judge", "reflection": "Allah is the absolute Judge…", "quran_references": ["6:114", "13:41"] } }

find_verses

Topic lookup beside get_quran_verse's reference lookup (WO#386). The query is normalised and each word is matched to a theme of AskSakina's thematic verse index (anxiety, gratitude, patience, trust, grief, hope, forgiveness, morning, friday, ramadan, encouragement), by theme name or a fixed synonym list. Deterministic: no embedding, no AI call.

2.5.0 (WO#495) adds fifteen themes, each with its verses in a ruled order: companionship, family_and_marriage, hereafter, parents, night_and_rest, character, justice, protection, quran_and_knowledge, faith_and_guidance, prophets_and_creation, seasons, provision, healing and certainty. Companionship (loneliness) carries the soft support block, as grief does, and no teaching content. Healing carries one more directive: the verses are spiritual comfort and do not replace medical care. A query that carries an abuse word the crisis detector does not read alone ("abuse", "abusive", "violence" and their forms) reaches none of the fifteen and is answered as 2.4 answered it. Since 2.5.1 (WO#500), disclosure phrases built on t