get_translation_text

Fetch translation text as plain data for inline quoting, comparison, or analysis (no UI widget).

Widget counterpart: ayah_translation — use that for full interactive translation display.

Use This When

• You need to incorporate translation excerpts directly into your response text.
• You want to compare translations without rendering a widget.
• The user asks a question that requires quoting a specific translation.

Input

• queries (array, required): Translation queries. Each query defines an ayah range plus languages or slugs.
  • start_ayah (string, required): Ayah key in surah:ayah format (e.g., "2:255").
  • end_ayah (string, optional): End ayah key. Omit to fetch only start_ayah.
  • languages (string[], optional): ISO 639-1 codes (e.g., "en", "ur"). Do not use "ar".
  • translations (string[], optional): Translator slugs (e.g., "en-saheeh-international").

Each query must include at least one of languages or translations.

Limits

• Max 50 queries per call.
• Max 200 ayahs per request.
• Max 10 translations per query.

Example User Prompts

• "What does Saheeh International say about 2:255?" (agent calls get_translation_text and quotes inline)
• "Give me the English translation of the first 3 ayahs of Al-Fatiha."

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_translation_text",
    "arguments": {
      "queries": [
        {
          "start_ayah": "2:255",
          "languages": ["en"]
        }
      ]
    }
  }
}