plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "qurani-ai",
  "version": "1.0.2",
  "description": "Read, search and listen to the Holy Quran: Arabic text in Hafs and other narrations, translations, tafsir, recitations, tajweed and word-by-word Arabic grammar. Read-only; no account needed.",
  "author": {
    "name": "Misraj AI",
    "email": "hello@misraj.ai",
    "url": "https://misraj.ai"
  },
  "homepage": "https://qurani.ai",
  "keywords": [
    "quran",
    "tafsir",
    "translation",
    "recitation",
    "tajweed",
    "arabic",
    "islam"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Qurani.ai",
        "shortDescription": "Read, study and hear the Quran",
        "longDescription": "Qurani.ai brings the Holy Quran into ChatGPT. Read any ayah (verse), surah (chapter), mushaf page, juz, or hizb in Arabic, in Hafs and other narrations (riwayat) such as Warsh and Qalun, with translations in many languages. Explain any ayah with tafsir (commentary) in Arabic and many other languages, including Ibn Kathir, Al-Tabari, Al-Sa'di, and Al-Jalalayn.\n\nSearch the Arabic text or a translation by word or phrase, and find similar ayahs, repeated phrases (mutashabihat), and themes. Listen to recitations from a wide choice of reciters, of whole surahs or single ayahs, and hear individual words pronounced. See the tajweed (recitation) rules on every word, explore Arabic grammar word by word (root, pattern, and part of speech), and compare how the narrations differ on any mushaf page. Asking for an ayah shows an interactive card with the Arabic text, translations, and a recitation player.\n\nWho it is for: students and teachers of the Quran, Arabic learners, people memorising the Quran (hifz), researchers, and developers building Quran apps, who also get mushaf page layouts (Madani, Indo-Pak, and others), Quran fonts, and QPC glyph codes.\n\nLimitations: Qurani.ai is read-only and needs no account. It returns published texts, translations, and tafsir as they are, and it does not issue religious rulings (fatwas); translations and tafsir reflect the views of their authors. All audio is recorded by human reciters; nothing is AI-generated.",
        "developerName": "Misraj AI",
        "category": "Education & Research",
        "capabilities": [
          "Read ayahs, surahs, and mushaf pages in Arabic and in several narrations",
          "Translations and tafsir in many languages",
          "Search the Quran and find similar ayahs",
          "Recitation audio for surahs, ayahs, and single words",
          "Tajweed rules for every word",
          "Word-by-word Arabic grammar",
          "Compare narrations on a mushaf page",
          "Mushaf page layouts, Quran fonts, and glyph codes"
        ],
        "websiteURL": "https://qurani.ai",
        "supportURL": "https://qurani.ai/en/support",
        "privacyPolicyURL": "https://qurani.ai/en/privacy",
        "termsOfServiceURL": "https://qurani.ai/en/terms",
        "defaultPrompt": [
          "Show me Ayat al-Kursi (2:255) in Arabic with an English translation and a recitation.",
          "What does Tafsir Ibn Kathir say about the first ayah of Surah Al-Ikhlas?",
          "Find ayahs about patience and list them with their references."
        ],
        "brandColor": "#008000",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read an ayah with a translation and its recitation, shown in the interactive ayah card.",
              "prompt": "Show me Ayat al-Kursi (2:255) in Arabic with the Sahih International translation, and let me hear Mishary Alafasy recite it.",
              "tools_triggered": "get_ayah, get_ayah_audio",
              "expected_behavior": "Shows ayah 2:255 in Arabic with the Sahih International translation in the ayah card, with a playable recitation by Mishary Alafasy."
            },
            {
              "description": "Explain an ayah with a named classical tafsir.",
              "prompt": "What does Tafsir Ibn Kathir say about the first ayah of Surah Al-Ikhlas?",
              "tools_triggered": "get_tafsir",
              "expected_behavior": "Answers from Ibn Kathir's tafsir of ayah 112:1, quoting or summarising the commentary and naming the source."
            },
            {
              "description": "Find ayahs on a topic in an English translation.",
              "prompt": "Find ayahs about patience and list them with their references.",
              "tools_triggered": "search_quran",
              "expected_behavior": "Lists ayahs that mention patience, starting with 2:45, each with its surah:ayah reference and text."
            },
            {
              "description": "Explain the tajweed rules of an ayah word by word.",
              "prompt": "Explain the tajweed rules in Bismillah (1:1), word by word.",
              "tools_triggered": "get_ayah_tajweed",
              "expected_behavior": "Goes through the four words of ayah 1:1 and explains the tajweed rules found on each word in plain language."
            },
            {
              "description": "The same ayah request on the ChatGPT mobile app: the ayah card fits the phone screen and its recitation plays.",
              "prompt": "Show me Ayat al-Kursi (2:255) in Arabic with the Sahih International translation, and let me hear Mishary Alafasy recite it.",
              "tools_triggered": "get_ayah, get_ayah_audio",
              "expected_behavior": "On the ChatGPT mobile app, the ayah card shows ayah 2:255 in Arabic with the Sahih International translation, fits the screen, and plays Mishary Alafasy's recitation."
            }
          ],
          "negative": [
            {
              "description": "Unrelated request. This is not a Quran question, so Qurani.ai should not be called; ChatGPT answers without its tools.",
              "prompt": "What's the weather in Cairo tomorrow?"
            },
            {
              "description": "Request to change data. Qurani.ai is read-only and has no tool that edits texts or translations, so it should not attempt a change; ChatGPT explains that the source texts can't be edited, and may show the current translation instead.",
              "prompt": "Change the English translation of ayah 2:255 to my own wording and save it."
            },
            {
              "description": "Request for AI-generated audio. Qurani.ai only links to recordings by human reciters and does not generate audio, so it should not try to create one; at most it offers an existing recitation of Al-Fatiha.",
              "prompt": "Generate an AI recitation of Surah Al-Fatiha in my own voice."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Qurani.ai does not sell anything or process payments."
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release of Qurani.ai: read the Quran in Arabic and in several narrations with translations and tafsir, search it, listen to recitations, study tajweed and word-by-word grammar, compare narrations, and use mushaf page layouts, Quran fonts and glyph codes. Includes the interactive ayah card."
      },
      "apps": "./.app.json"
    }
  }
}