Skip to main content
Glama
Sign In

AskSakina Islamic Knowledge

by com.asksakina
OverviewDiscussionsAdmin

get_quran_verse

get_quran_verse

Returns one Quran verse by surah and ayah number: Tanzil Uthmani Arabic and Pickthall English, with citation. Quote the Arabic exactly; do not paraphrase either text.

Input Schema

NameRequiredDescriptionDefault
ayahYesAyah (verse) number within the surah
surahYesSurah number, 1-114
localeNoTranslation locale; defaults to "en" (Pickthall). Urdu, Indonesian and Turkish translations are not yet available: "ur", "id" and "tr" return Pickthall English with a note.
audienceNoOptional: 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

NameRequiredDescriptionDefault
contentYes
_sakina_metaYes
crisis_resourceNoPresent 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.

  1. Changed1 schema field changed
    • 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": [
+            "quran_verse",
+            "not_found"
+          ],
+          "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": {
+            "arabic_text": {
+              "type": "string"
+            },
+            "ayah": {
+              "type": "integer"
+            },
+            "related": {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "call": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "arguments": {
+                        "additionalProperties": true,
+                        "properties": {},
+                        "type": "object"
+                      },
+                      "tool": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "tool",
+                      "arguments"
+                    ],
+                    "type": "object"
+                  },
+                  "kind": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "kind",
+                  "label",
+                  "call"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "surah_name_arabic": {
+              "type": "string"
+            },
+            "surah_name_english": {
+              "type": "string"
+            },
+            "surah_number": {
+              "type": "integer"
+            },
+            "teach": {
+              "additionalProperties": true,
+              "properties": {
+                "audience": {
+                  "type": "string"
+                },
+                "record_id": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "record_id",
+                "audience"
+              ],
+              "type": "object"
+            },
+            "translation": {
+              "type": "string"
+            },
+            "translation_language": {
+              "type": "string"
+            },
+            "translation_note": {
+              "type": "string"
+            },
+            "translation_source": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "surah_number",
+            "surah_name_arabic",
+            "surah_name_english",
+            "ayah",
+            "arabic_text",
+            "translation",
+            "translation_source",
+            "translation_language"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "reason": {
+              "type": "string"
+            },
+            "requested": {
+              "additionalProperties": true,
+              "properties": {
+                "ayah": {
+                  "type": "number"
+                },
+                "locale": {
+                  "type": "string"
+                },
+                "surah": {
+                  "type": "number"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "required": [
+            "requested",
+            "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"
+}
  2. Changed2 schema fields changed
    • changedInput schema / properties / locale / description
      Previous value: -"Translation locale; defaults to \"en\" (Pickthall). Urdu and Indonesian translations are not yet available: \"ur\" and \"id\" return Pickthall English with a note."New value: +"Translation locale; defaults to \"en\" (Pickthall). Urdu, Indonesian and Turkish translations are not yet available: \"ur\", \"id\" and \"tr\" return Pickthall English with a note."
    • changedInput schema / properties / locale / enum
      Previous value: -[
-  "en",
-  "id",
-  "ur",
-  "ar"
-]New value: +[
+  "en",
+  "id",
+  "ur",
+  "ar",
+  "tr"
+]
  3. Changed1 schema field changed
    • 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."
  4. Changed1 schema field changed
    • 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"
+}
  5. First observed

TDQS

A4/5.0
Behavior4/5

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

With no annotations, the description carries the behavioral burden and usefully discloses the returned content: Tanzil Uthmani Arabic, Pickthall English, and a citation. It also adds an important output constraint to quote exactly and not paraphrase, though it does not describe invalid-reference behavior.

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?

The definition is two front-loaded sentences with no wasted language. The second sentence earns its place by adding a concrete quotation constraint.

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?

Given the rich input schema and the presence of an output schema, the description is nearly complete for exact verse retrieval and quotation behavior. The main remaining gap is routing guidance versus find_verses, plus no explicit statement about invalid surah/ayah handling.

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 the schema already documents surah, ayah, locale fallback behavior, and audience. The description restates the required surah/ayah lookup but adds little parameter meaning beyond what the schema provides, making the baseline 3 appropriate.

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

Purpose5/5

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

The description states a specific verb and resource: returns one Quran verse by surah and ayah number, with named Arabic and English sources plus citation. The singular exact-verse scope clearly distinguishes it from the sibling find_verses tool.

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 required surah and ayah inputs imply use for exact-reference lookup, but the description never explicitly says when to choose this over find_verses or when not to use it. Usage is therefore implied rather than fully guided.

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 toolsInspect
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.

Resources