Skip to main content
Glama
Sign In

AskSakina Islamic Knowledge

by com.asksakina
OverviewDiscussionsAdmin

find_verses

find_verses

Searches AskSakina's thematic index for Quran verses by topic keyword. Returns reference, Tanzil Arabic and Pickthall English. Quote the Arabic exactly.

Input Schema

NameRequiredDescriptionDefault
limitNoNumber of verses to return; default 5, max 10.
queryYesTopic or keyword, e.g. 'patience', 'grief', 'gratitude', 'hope'.
localeNoSelects the in-country crisis resources if one is needed; defaults to "en". Translations are Pickthall English.
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": [
+            "verse_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": {
+            "matched_themes": {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "theme": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "theme"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "no_results": {
+              "type": "boolean"
+            },
+            "query": {
+              "type": "string"
+            },
+            "total_results": {
+              "type": "integer"
+            },
+            "verses": {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "arabic": {
+                    "type": "string"
+                  },
+                  "reference": {
+                    "type": "string"
+                  },
+                  "relevance_note": {
+                    "type": "string"
+                  },
+                  "surah_name_arabic": {
+                    "type": "string"
+                  },
+                  "surah_name_english": {
+                    "type": "string"
+                  },
+                  "translation": {
+                    "type": "string"
+                  },
+                  "translation_source": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "reference",
+                  "surah_name_english",
+                  "surah_name_arabic",
+                  "arabic",
+                  "translation",
+                  "translation_source",
+                  "relevance_note"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "query",
+            "matched_themes",
+            "verses",
+            "total_results",
+            "no_results"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "available_themes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "no_results": {
+              "type": "boolean"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "requested": {
+              "additionalProperties": true,
+              "properties": {
+                "query": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "query"
+              ],
+              "type": "object"
+            },
+            "total_results": {
+              "type": "integer"
+            },
+            "verses": {
+              "items": {},
+              "type": "array"
+            }
+          },
+          "required": [
+            "requested",
+            "verses",
+            "total_results",
+            "no_results",
+            "reason",
+            "available_themes"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "reason": {
+              "type": "string"
+            },
+            "requested": {
+              "additionalProperties": true,
+              "properties": {
+                "query": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "query"
+              ],
+              "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"
+}
  2. Changed1 schema field changed
    • 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

A3.6/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral burden. It usefully states what is returned and warns to quote the Arabic exactly, but it does not describe read-only/search behavior, permissions, rate limits, or failure modes.

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?

Three short sentences, front-loaded with purpose and followed by return format and the key quoting instruction. There is no redundant or wasted text.

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 full schema coverage and an output schema, the description is nearly sufficient: it covers purpose, return composition, and a critical usage rule. The main gap is not explicitly routing against the sibling get_quran_verse.

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 description coverage is 100%, so the parameter meanings are already fully documented. The description mentions topic keyword and return fields but adds no syntax, constraints, or semantics beyond the schema.

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?

The description names a specific verb, resource, and retrieval mode: search a thematic index for Quran verses by topic keyword. This clearly separates it from exact-reference retrieval, but it does not explicitly name or contrast the sibling get_quran_verse.

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 topic-keyword scope implies when to use this tool, but there is no explicit when-not guidance or reference to alternatives such as get_quran_verse. An agent can infer usage but must rely on the tool name and schema for routing.

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