ayah_translation

Show Quran ayah translations.

Use This When

• The user asks for non-Arabic translation text for ayah ranges.
• The user asks for output from specific translators by slug.

Widget Preview

Submission Scenario

Live-captured prompt, MCP request, and expected response used for the OpenAI submission. Regenerate with bun run capture:submission from the repo root.

{
  "prompt": "Show me Ayat al-Kursi (2:255) with three English translations (Saheeh International, Clear Quran, Taqi Usmani).",
  "request": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "ayah_translation",
      "arguments": {
        "queries": [
          {
            "start_ayah": "2:255",
            "translations": ["en-sahih-international", "clearquran-with-tafsir", "en-taqi-usmani"]
          }
        ]
      }
    }
  },
  "response": {
    "ayahs": [
      {
        "ayah_key": "2:255",
        "text_arabic": "اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ الْحَيُّ الْقَيُّومُ ۚ لَا تَأْخُذُهُ سِنَةٌ وَلَا نَوْمٌ ۚ لَّهُ مَا فِي السَّمَاوَاتِ وَمَا فِي الْأَرْضِ ۗ مَن ذَا الَّذِي يَشْفَعُ عِندَهُ إِلَّا بِإِذْنِهِ ۚ يَعْلَمُ مَا بَيْنَ أَيْدِيهِمْ وَمَا خَلْفَهُمْ ۖ وَلَا يُحِيطُونَ بِشَيْءٍ مِّنْ عِلْمِهِ إِلَّا بِمَا شَاءَ ۚ وَسِعَ كُرْسِيُّهُ السَّمَاوَاتِ وَالْأَرْضَ ۖ وَلَا يَئُودُهُ حِفْظُهُمَا ۚ وَهُوَ الْعَلِيُّ الْعَظِيمُ",
        "chapter_name": "Al-Baqarah",
        "chapter_name_arabic": "البقرة",
        "translations": [
          {
            "language": "en",
            "translator": "Dr. Mustafa Khattab, the Clear Quran",
            "text": "Allah! There is no god ˹worthy of worship˺ except Him, the Ever-Living, All-Sustaining. Neither drowsiness nor sleep overtakes Him. To Him belongs whatever is in the heavens and whatever is on the earth. Who could possibly intercede with Him without His permission? He ˹fully˺ knows what is ahead of them and what is behind them, but no one can grasp any of His knowledge—except what He wills ˹to reveal˺. His Seat encompasses the heavens and the earth, and the preservation of both does not tire Him. For He is the Most High, the Greatest."
          },
          {
            "language": "en",
            "translator": "Mufti Taqi Usmani",
            "text": "Allah: There is no god but He, the Living, the All-Sustaining. Neither dozing overtakes Him nor sleep. To Him belongs all that is in the heavens and all that is on the earth. Who can intercede with Him without His permission? He knows what is before them and what is behind them; while they encompass nothing of His knowledge, except what He wills. His Kursiyy (Chair) extends to the Heavens and to the Earth, and it does not weary Him to look after them. He is the All-High, the Supreme."
          },
          {
            "language": "en",
            "translator": "Saheeh International",
            "text": "Allāh - there is no deity except Him, the Ever-Living, the Self-Sustaining. Neither drowsiness overtakes Him nor sleep. To Him belongs whatever is in the heavens and whatever is on the earth. Who is it that can intercede with Him except by His permission? He knows what is [presently] before them and what will be after them, and they encompass not a thing of His knowledge except for what He wills. His Kursī extends over the heavens and the earth, and their preservation tires Him not. And He is the Most High, the Most Great."
          }
        ]
      }
    ],
    "total_ayahs": 1,
    "languages_used": ["en"]
  }
}

Input

• queries (array, required, min 1, max 50): List of translation queries.
• Each query must include at least one of languages or translations.

Each query:

• start_ayah (string, required): Start ayah key in "surah:ayah" format (for example "2:255").
• end_ayah (string, optional): End ayah key in "surah:ayah" format. Omit to request only start_ayah.
• languages (string[], optional): ISO 639-1 language codes only (for example ["en", "ur"]). Do not use names like "english". Do not include "ar".
• translations (string[], optional): Translator slugs (for example ["en-saheeh-international"]).

Available Translation Slugs

Current translation slugs and display names:

84 translation slugs

• english
  • bridges-translation: Fadel Soliman, Bridges' translation
  • clearquran-with-tafsir: Dr. Mustafa Khattab, the Clear Quran
  • en-al-maududi: Tafheem-ul-Quran - Abul Ala Maududi
  • en-arberry: A. J. Arberry
  • en-asad: Muhammad Asad
  • en-daryabadi: Abdul Majid Daryabadi
  • en-ghali: Dr. Ghali
  • en-haleem: Abdul Haleem
  • en-maarif-ul-quran: Maarif-ul-Quran
  • en-maulana-wahiduddin-khan: Maulana Wahiduddin Khan
  • en-muhsin-khan: Muhsin Khan
  • en-qaribullah: Professor Shaykh Hasan Al-Fatih Qaribullah
  • en-sahih-international: Saheeh International
  • en-sarwar: Muhammad Sarwar
  • en-shakir: Shakir
  • en-taqi-usmani: Mufti Taqi Usmani
  • quran.en.pickthall: English Translation (Pickthall)
  • quran.en.yusufali: Abdullah Yusuf Ali
  • transliteration: Transliteration
• urdu
  • bayan-ul-quran: Bayan-ul-Quran
  • maududi-roman-urdu: Abul Ala Maududi(Roman Urdu)
  • maulana-wahid-uddin-khan-urdu: Maulana Wahiduddin Khan
  • tafsir-e-usmani: Shaykh al-Hind Mahmud al-Hasan(with Tafsir E Usmani)
  • ur-al-maududi: Tafheem e Qur'an - Syed Abu Ali Maududi
  • ur-fatah-muhammad-jalandhari: Fatah Muhammad Jalandhari
  • ur-junagarri: Maulana Muhammad Junagarhi
  • urdu-sayyid-qatab: Fe Zilal al-Qur'an
• bengali
  • bn-rawai-al-bayan: Rawai Al-bayan
  • bn-sheikh-mujibur-rahman: Sheikh Mujibur Rahman
  • bn-taisirul-quran: Taisirul Quran
  • fathul-majid-bn: Fathul Majid
• russian
  • quran.ru.kuliev: Russian Translation ( Elmir Kuliev )
  • ru-abu-adel: Abu Adel
  • ru-gordy: Gordy Semyonovich Sablukov
  • ru-ministry-of-awqaf: Ministry of Awqaf, Egypt
  • ru-nuri: Magomed-Nuri Osmanovich Osmanov
• albanian
  • al-hasan-efendi: Hasan Efendi Nahi
  • quran.al.ahmeti: Albanian Translation
  • sq-unknown: Albanian
• azeri
  • az-alikhan: Alikhan Musayev
  • az-unknown: Azerbaijani
• dutch
  • nl-abdalsalaam: Malak Faris Abdalsalaam
  • nl_sofian_s._siregar: Sofian S. Siregar
• french
  • fr-rashid-maash: Rashid Maash
  • quran.fr.hamidullah: Muhammad Hamidullah
• spanish
  • es-isa-garcia: Sheikh Isa Garcia
  • quran.es.cortes: Spanish Translation(Cortes)
• malayalam
  • ml-karakunnu: Muhammad Karakunnu and Vanidas Elayavoor
  • quran.ml.abdul.hameed: Malay Translation(Abdul Hameed and Kunhi)
• single-entry languages
  • am-sadiq: Sadiq and Sani
  • bs-unknown: Muhamed Mehanovic
  • chechen-translation: Magomed Magomedov
  • cs-unknown: Czech
  • de-bubenheim: Frank Bubenheim and Nadeem
  • dv-unknow: Office of the president of Maldives
  • fi-unknown: Finnish
  • fr-hussein-taji: Hussein Taji Kal Dari
  • hamza-roberto-piccardo: Hamza Roberto Piccardo
  • ja-ryoichi-mita: Ryoichi Mita
  • kannada-quran: Kannada Translation
  • ko-unknown: Korean
  • ku-burhan-muhammad: Burhan Muhammad-Amin
  • moore-rwwad: Moore rwwad
  • mrn-unknown: Maranao
  • no-unknown: Norwegian
  • pl-jozef-bielawski: Jozef Bielawski
  • qoran-imqaddes: Il-Qoran Imqaddes
  • quran,pt.samir: Portuguese Translation( Samir )
  • quran.ha.abubakar: Hausa Translation(Abubakar Gumi)
  • quran.id: Indonesian Islamic affairs ministry
  • quran.th.quran.complex: Thai Translatio (King Fahad Quran Complex)
  • quran.tr.diyanet: Turkish Translation(Diyanet)
  • quran.uz.sodik: Muhammad Sodiq Muhammad Yusuf (Latin)
  • quran.zh.ma.jain: Chinese Translation (Simplified) - Ma Jain
  • ro-grigore: Grigore
  • so-mahmud-abduh: Mahmud Muhammad Abduh
  • sv-knut: Knut Bernstrom
  • sw-ali-muhsin: Ali Muhsin Al-Barwani
  • ta-jan-trust: Jaan Trust Foundation
  • tg-ayati: Tajik
  • tr-hamdi: Elmalili Hamdi Yazir
  • tt-unknow: Tatar
  • ug-saleh: Muhammad Saleh

Limits

• Maximum 50 queries per call
• Maximum 200 ayahs per request
• Maximum 10 resolved translations per query

Example User Prompts

• "Translate Surah Al-Fatiha to English."
• "Give English and Urdu translations for ayah 2:255."
• "Show French translations for verses 18:1 to 18:10."

Example Request

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