list_translations

List available Quran translations with optional language filtering.

Use This When

• The user asks what translation options are available.
• You need translation slugs before calling ayah_translation.

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": "What English translations of the Quran are available?",
  "request": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_translations",
      "arguments": {
        "language": "en"
      }
    }
  },
  "response": {
    "translations": [
      {
        "slug": "clearquran-with-tafsir",
        "name": "Dr. Mustafa Khattab, the Clear Quran",
        "language_name": "english",
        "translated_name": {
          "name": "Dr. Mustafa Khattab",
          "locale": "en"
        }
      },
      {
        "slug": "bridges-translation",
        "name": "Fadel Soliman, Bridges’ translation",
        "language_name": "english",
        "translated_name": {
          "name": "Fadel Soliman, Bridges’ translation",
          "locale": "en"
        }
      },
      {
        "slug": "en-sahih-international",
        "name": "Saheeh International",
        "language_name": "english",
        "translated_name": {
          "name": "Saheeh International",
          "locale": "en"
        }
      },
      {
        "slug": "en-maarif-ul-quran",
        "name": "Maarif-ul-Quran",
        "language_name": "english",
        "translated_name": {
          "name": "Maarif-ul-Quran",
          "locale": "en"
        }
      },
      {
        "slug": "en-taqi-usmani",
        "name": "Mufti Taqi Usmani",
        "language_name": "english",
        "translated_name": {
          "name": "Mufti Taqi Usmani",
          "locale": "en"
        }
      },
      {
        "slug": "en-haleem",
        "name": "Abdul Haleem",
        "language_name": "english",
        "translated_name": {
          "name": "Abdul Haleem",
          "locale": "en"
        }
      },
      {
        "slug": "en-ghali",
        "name": "Dr. Ghali",
        "language_name": "english",
        "translated_name": {
          "name": "Dr. Ghali",
          "locale": "en"
        }
      },
      {
        "slug": "en-muhsin-khan",
        "name": "Muhsin Khan",
        "language_name": "english",
        "translated_name": {
          "name": "Muhsin Khan",
          "locale": "en"
        }
      },
      {
        "slug": "en-al-maududi",
        "name": "Tafheem-ul-Quran - Abul Ala Maududi",
        "language_name": "english",
        "translated_name": {
          "name": "Tafheem-ul-Quran - Abul Ala Maududi",
          "locale": "en"
        }
      },
      {
        "slug": "en-shakir",
        "name": "Shakir",
        "language_name": "english",
        "translated_name": {
          "name": "Shakir",
          "locale": "en"
        }
      },
      {
        "slug": "transliteration",
        "name": "Transliteration",
        "language_name": "english",
        "translated_name": {
          "name": "Transliteration",
          "locale": "en"
        }
      },
      {
        "slug": "quran.en.pickthall",
        "name": "English Translation (Pickthall)",
        "language_name": "english",
        "translated_name": {
          "name": "English Translation (Pickthall)",
          "locale": "en"
        }
      },
      {
        "slug": "quran.en.yusufali",
        "name": "Abdullah Yusuf Ali",
        "language_name": "english",
        "translated_name": {
          "name": "Abdullah Yusuf Ali",
          "locale": "en"
        }
      },
      {
        "slug": "en-maulana-wahiduddin-khan",
        "name": "Maulana Wahiduddin Khan",
        "language_name": "english",
        "translated_name": {
          "name": "Maulana Wahiduddin Khan",
          "locale": "en"
        }
      },
      {
        "slug": "en-arberry",
        "name": "A. J. Arberry",
        "language_name": "english"
      },
      {
        "slug": "en-asad",
        "name": "Muhammad Asad",
        "language_name": "english"
      },
      {
        "slug": "en-daryabadi",
        "name": "Abdul Majid Daryabadi",
        "language_name": "english"
      },
      {
        "slug": "en-qaribullah",
        "name": "Professor Shaykh Hasan Al-Fatih Qaribullah",
        "language_name": "english"
      },
      {
        "slug": "en-sarwar",
        "name": "Muhammad Sarwar",
        "language_name": "english"
      }
    ],
    "totalCount": 19,
    "languageFilter": "en"
  }
}

Input

Optional:

• language (string, optional): ISO 639-1 language code filter (for example "en"). Do not use names like "english".
• locale (string, optional): Locale/language code used for localized metadata in response (for example "en" or "ar").

Note: language_name in response items is display text and should not be sent as ayah_translation input. Only translations with usable non-empty slugs are returned.

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

Example User Prompts

• "List available Quran translations."
• "Show English translation options."
• "Which translation slugs can I use?"

Example Request

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "list_translations",
    "arguments": {
      "language": "en"
    }
  }
}