get_tafsir_text

Fetch tafsir commentary as plain text for inline quoting, summarizing, or analysis (no UI widget).

Widget counterpart: ayah_tafsir — use that for full interactive tafsir display.

Use This When

• You need to reference or summarize tafsir content directly in your response.
• The user asks what a specific scholar says about an ayah and expects a quoted answer.
• You need tafsir data for analysis without rendering a widget.

Input

• queries (array, required): Tafsir queries. Each query defines an ayah range plus languages or tafsir 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.
  • tafsir_slugs (string[], optional): Specific tafsir slugs (e.g., "en-tafsir-ibn-kathir").
  • languages (string[], optional): ISO 639-1 codes for default tafsir selection (e.g., "en", "ar").

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

Limits

• Max 20 queries per call.
• Max 50 ayah+tafsir items per request.

Example User Prompts

• "What does Ibn Kathir say about 2:255?" (agent calls get_tafsir_text and quotes inline)
• "Summarize the tafsir of Surah Al-Fatiha verse 1."

Example Request

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