Get ayahs
qul_get_versesRetrieve the Arabic text of a single ayah or range within a surah, with optional translations, metadata, and word-by-word data for Quran study or app integration.
Instructions
Get the Arabic text of one ayah or a range inside a surah, optionally with translations and word-by-word data. For a single ayah pass the same key as from and to, e.g. from "2:255".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"from": "<from>"
},
"name": "qul_get_verses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last ayah in the same surah, e.g. "2:257". Defaults to from. | |
| from | Yes | First ayah, e.g. "2:255" | |
| scripts | No | Arabic script variants to include. Defaults to text_uthmani. | |
| metadata | No | Extra per-ayah fields such as juz_number or sajdah_type | |
| text_format | No | "text" strips HTML and footnote markers (default); "html" returns QUL's markup as-is | text |
| word_fields | No | Word fields to include when include_words is true, e.g. en_transliteration | |
| include_words | No | Include word-by-word breakdown | |
| translation_ids | No | Translation resource IDs to attach (max 10), e.g. [20] for Saheeh International. See qul_list_resources. | |
| word_translation_language | No | ISO code for word-by-word meanings, e.g. "en", "ur", "id". Implies include_words. |