AskSakina Islamic Knowledge

get_dua

get_dua

Returns du'as from a curated du'a corpus for a life context (e.g. anxiety, travel, gratitude), with source and grading where recorded. Show any crisis_resource block verbatim.

Input Schema

Name	Required	Description
`id`	No	A du'a id taken from a related reference in an earlier response. Send this or context, not both.
`limit`	No	Number of du'as to return for a context; default 3, max 10. The response says how many more exist. Ignored with id.
`locale`	No	Locale; defaults to "en". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or "en", in the language of the crisis words (Indonesian, Urdu, Arabic, Turkish, Bengali or Persian).
`offset`	No	Number of du'as to skip before the page, for paging with limit; default 0. Ignored with id, and on the bereaved set.
`context`	No	Life context to match against. Examples: 'anxiety', 'morning', 'travel', 'forgiveness', 'gratitude'. Send this or id, not both.
`audience`	No	Optional: curious, revert or practising, from the user's own self-description only. Teaching context attaches whenever an entry exists; omit when the audience is unknown.

Output Schema

Name	Required	Description
`content`	Yes
`_sakina_meta`	Yes
`crisis_resource`	No	Present this block exactly, before anything else, and add nothing religious when content_type is crisis_resource_only.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "_sakina_meta": {
+      "additionalProperties": true,
+      "properties": {
+        "content_type": {
+          "enum": [
+            "dua_collection",
+            "not_found",
+            "crisis_resource_only"
+          ],
+          "type": "string"
+        },
+        "disclaimer": {
+          "type": "string"
+        },
+        "disclaimer_locale": {
+          "const": "en",
+          "type": "string"
+        },
+        "educational_context": {
+          "type": "string"
+        },
+        "llm_directives": {
+          "additionalProperties": true,
+          "properties": {
+            "CRITICAL_RULES": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "CRITICAL_RULES"
+          ],
+          "type": "object"
+        },
+        "presentation_contract": {
+          "additionalProperties": true,
+          "properties": {},
+          "type": "object"
+        },
+        "source": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "version",
+        "source",
+        "content_type",
+        "disclaimer",
+        "llm_directives",
+        "presentation_contract",
+        "educational_context"
+      ],
+      "type": "object"
+    },
+    "content": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "properties": {
+            "context": {
+              "type": "string"
+            },
+            "duas": {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "arabic": {
+                    "type": "string"
+                  },
+                  "context_tags": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "dua_block": {
+                    "type": "string"
+                  },
+                  "grading": {
+                    "type": "string"
+                  },
+                  "grading_status": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "translation": {
+                    "type": "string"
+                  },
+                  "transliteration": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "dua_block",
+                  "title",
+                  "arabic",
+                  "transliteration",
+                  "translation",
+                  "source",
+                  "grading",
+                  "grading_status",
+                  "context_tags"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "grading_summary": {
+              "additionalProperties": true,
+              "properties": {
+                "graded": {
+                  "type": "integer"
+                },
+                "not_a_narration": {
+                  "type": "integer"
+                },
+                "not_recorded": {
+                  "type": "integer"
+                },
+                "quranic": {
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "quranic",
+                "graded",
+                "not_a_narration",
+                "not_recorded"
+              ],
+              "type": "object"
+            },
+            "id": {
+              "type": "string"
+            },
+            "matched_by": {
+              "additionalProperties": true,
+              "properties": {
+                "method": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "method"
+              ],
+              "type": "object"
+            },
+            "total_available": {
+              "type": "integer"
+            },
+            "total_results": {
+              "type": "integer"
+            },
+            "truncated": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "duas",
+            "total_results"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "reason": {
+              "type": "string"
+            },
+            "requested": {
+              "additionalProperties": true,
+              "properties": {
+                "context": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "required": [
+            "requested",
+            "reason"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "reason": {
+              "type": "string"
+            },
+            "requested": {
+              "additionalProperties": true,
+              "properties": {
+                "context": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "withheld": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "requested",
+            "withheld",
+            "reason"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "crisis_resource": {
+      "additionalProperties": true,
+      "description": "Present this block exactly, before anything else, and add nothing religious when content_type is crisis_resource_only.",
+      "properties": {
+        "crisis_type": {
+          "type": "string"
+        },
+        "directive": {
+          "type": "string"
+        },
+        "level": {
+          "enum": [
+            "hard",
+            "soft"
+          ],
+          "type": "string"
+        },
+        "locale": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "level",
+        "locale",
+        "directive",
+        "text"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "_sakina_meta",
+    "content"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 23, 2026

changedInput schema / properties / locale / description

Previous value: -"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or \"en\", in the language of the crisis words (Indonesian, Urdu, Arabic or Turkish; Bengali and Persian get the English text with local helplines)."New value: +"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or \"en\", in the language of the crisis words (Indonesian, Urdu, Arabic, Turkish, Bengali or Persian)."

Changed1 schema field changedOct 23, 2026

changedInput schema / properties / locale / description

Previous value: -"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or \"en\", in the language of the crisis words (Indonesian, Urdu, Arabic or Turkish)."New value: +"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or \"en\", in the language of the crisis words (Indonesian, Urdu, Arabic or Turkish; Bengali and Persian get the English text with local helplines)."

Changed1 schema field changedOct 21, 2026

changedInput schema / properties / locale / description

Previous value: -"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale."New value: +"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale, or, with no locale or \"en\", in the language of the crisis words (Indonesian, Urdu, Arabic or Turkish)."

Changed2 schema fields changedOct 21, 2026

changedInput schema / properties / locale / description

Previous value: -"Translation locale; defaults to \"en\". v1 returns English content for all locales."New value: +"Locale; defaults to \"en\". Du'a records are English for every locale; a crisis resource is given in the request locale."

changedInput schema / properties / locale / enum

Previous value: -[
-  "en",
-  "id",
-  "ur",
-  "ar"
-]New value: +[
+  "en",
+  "id",
+  "ur",
+  "ar",
+  "tr"
+]

Changed3 schema fields changedOct 21, 2026

changedInput schema / properties / audience / description

Previous value: -"Optional: curious, revert or practising. Returns pre-authored teaching context where available; omit for the standard record."New value: +"Optional: curious, revert or practising, from the user's own self-description only. Teaching context attaches whenever an entry exists; omit when the audience is unknown."

addedInput schema / properties / limit

Added value: +{
+  "description": "Number of du'as to return for a context; default 3, max 10. The response says how many more exist. Ignored with id.",
+  "maximum": 10,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / offset

Added value: +{
+  "description": "Number of du'as to skip before the page, for paging with limit; default 0. Ignored with id, and on the bereaved set.",
+  "minimum": 0,
+  "type": "integer"
+}

Changed4 schema fields changedSep 29, 2026

addedInput schema / properties / audience

Added value: +{
+  "description": "Optional: curious, revert or practising. Returns pre-authored teaching context where available; omit for the standard record.",
+  "enum": [
+    "curious",
+    "revert",
+    "practising"
+  ],
+  "type": "string"
+}

changedInput schema / properties / context / description

Previous value: -"Life context to match against. Examples: 'anxiety', 'morning', 'travel', 'forgiveness', 'gratitude'."New value: +"Life context to match against. Examples: 'anxiety', 'morning', 'travel', 'forgiveness', 'gratitude'. Send this or id, not both."

addedInput schema / properties / id

Added value: +{
+  "description": "A du'a id taken from a related reference in an earlier response. Send this or context, not both.",
+  "pattern": "^[A-Za-z0-9-]{3,40}$",
+  "type": "string"
+}

removedInput schema / required
```
Removed value: -[
-  "context"
-]
```

First observedSep 29, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden and does meaningful work: it discloses that results carry source and grading 'where recorded', and adds a safety-critical behavioral rule to render any crisis_resource block verbatim. It does not cover paging behavior or what an id lookup returns, but the crisis-handling instruction is exactly the kind of context annotations could never provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, both front-loaded and non-redundant: the first defines what is returned and the scoping input, the second is an operational instruction that changes agent behavior. Nothing could be removed without loss.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and the schema itself richly documents all parameters. The description is nearly sufficient, with the only real gap being the id-lookup mode, which an agent would only discover by reading the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so all six parameters are already documented, including the id/context exclusivity, limit defaults, and the unusual locale rule. The description only echoes the context parameter's purpose via examples, adding no meaning beyond the schema. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Returns du'as from a curated du'a corpus') plus the scoping concept ('for a life context') with concrete examples (anxiety, travel, gratitude). The resource is clearly distinct from siblings like get_quran_verse or get_name_of_allah, but the description never explicitly contrasts with them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'life context' framing implies when to reach for this tool, and the examples make the intended trigger concrete. However, it omits the id-based lookup path entirely (only the schema reveals 'id' takes precedence and is mutually exclusive with 'context'), and gives no when-not-to-use guidance or mention of the sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AskSakina Islamic Knowledge tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

get_dua

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources