phrase_mutashabihat

Show phrase mutashabihat occurrences.

Use This When

• The user provides phrase text and asks where it appears.
• You already have a phrase_id and need all occurrences.

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": "Where in the Quran does the phrase 'إن الله مع الصابرين' appear?",
  "request": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "phrase_mutashabihat",
      "arguments": {
        "phrase_text": "إن الله مع الصابرين"
      }
    }
  },
  "response": {
    "phrase_id": 15594,
    "found": true,
    "surahs": 2,
    "ayahs": 4,
    "count": 4,
    "source": {
      "key": "2:153",
      "from": 7,
      "to": 10
    },
    "occurrences": [
      {
        "ayah_key": "2:153",
        "ranges": [[7, 10]],
        "words": [
          "يَـٰٓأَيُّهَا",
          "ٱلَّذِينَ",
          "ءَامَنُوا۟",
          "ٱسْتَعِينُوا۟",
          "بِٱلصَّبْرِ",
          "وَٱلصَّلَوٰةِ ۚ",
          "إِنَّ",
          "ٱللَّهَ",
          "مَعَ",
          "ٱلصَّـٰبِرِينَ",
          "١٥٣"
        ],
        "surah_name": "Al-Baqarah"
      },
      {
        "ayah_key": "2:249",
        "ranges": [[58, 60]],
        "words": [
          "فَلَمَّا",
          "فَصَلَ",
          "طَالُوتُ",
          "بِٱلْجُنُودِ",
          "قَالَ",
          "إِنَّ",
          "ٱللَّهَ",
          "مُبْتَلِيكُم",
          "بِنَهَرٍۢ",
          "فَمَن",
          "شَرِبَ",
          "مِنْهُ",
          "فَلَيْسَ",
          "مِنِّى",
          "وَمَن",
          "لَّمْ",
          "يَطْعَمْهُ",
          "فَإِنَّهُۥ",
          "مِنِّىٓ",
          "إِلَّا",
          "مَنِ",
          "ٱغْتَرَفَ",
          "غُرْفَةًۢ",
          "بِيَدِهِۦ ۚ",
          "فَشَرِبُوا۟",
          "مِنْهُ",
          "إِلَّا",
          "قَلِيلًۭا",
          "مِّنْهُمْ ۚ",
          "فَلَمَّا",
          "جَاوَزَهُۥ",
          "هُوَ",
          "وَٱلَّذِينَ",
          "ءَامَنُوا۟",
          "مَعَهُۥ",
          "قَالُوا۟",
          "لَا",
          "طَاقَةَ",
          "لَنَا",
          "ٱلْيَوْمَ",
          "بِجَالُوتَ",
          "وَجُنُودِهِۦ ۚ",
          "قَالَ",
          "ٱلَّذِينَ",
          "يَظُنُّونَ",
          "أَنَّهُم",
          "مُّلَـٰقُوا۟",
          "ٱللَّهِ",
          "كَم",
          "مِّن",
          "فِئَةٍۢ",
          "قَلِيلَةٍ",
          "غَلَبَتْ",
          "فِئَةًۭ",
          "كَثِيرَةًۢ",
          "بِإِذْنِ",
          "ٱللَّهِ ۗ",
          "وَٱللَّهُ",
          "مَعَ",
          "ٱلصَّـٰبِرِينَ",
          "٢٤٩"
        ],
        "surah_name": "Al-Baqarah"
      },
      {
        "ayah_key": "8:46",
        "ranges": [[10, 13]],
        "words": [
          "وَأَطِيعُوا۟",
          "ٱللَّهَ",
          "وَرَسُولَهُۥ",
          "وَلَا",
          "تَنَـٰزَعُوا۟",
          "فَتَفْشَلُوا۟",
          "وَتَذْهَبَ",
          "رِيحُكُمْ ۖ",
          "وَٱصْبِرُوٓا۟ ۚ",
          "إِنَّ",
          "ٱللَّهَ",
          "مَعَ",
          "ٱلصَّـٰبِرِينَ",
          "٤٦"
        ],
        "surah_name": "Al-Anfal"
      },
      {
        "ayah_key": "8:66",
        "ranges": [[24, 26]],
        "words": [
          "ٱلْـَٔـٰنَ",
          "خَفَّفَ",
          "ٱللَّهُ",
          "عَنكُمْ",
          "وَعَلِمَ",
          "أَنَّ",
          "فِيكُمْ",
          "ضَعْفًۭا ۚ",
          "فَإِن",
          "يَكُن",
          "مِّنكُم",
          "مِّا۟ئَةٌۭ",
          "صَابِرَةٌۭ",
          "يَغْلِبُوا۟",
          "مِا۟ئَتَيْنِ ۚ",
          "وَإِن",
          "يَكُن",
          "مِّنكُمْ",
          "أَلْفٌۭ",
          "يَغْلِبُوٓا۟",
          "أَلْفَيْنِ",
          "بِإِذْنِ",
          "ٱللَّهِ ۗ",
          "وَٱللَّهُ",
          "مَعَ",
          "ٱلصَّـٰبِرِينَ",
          "٦٦"
        ],
        "surah_name": "Al-Anfal"
      }
    ],
    "match": {
      "found": true,
      "query": "إن الله مع الصابرين",
      "score": 75,
      "token_overlap": 0.75,
      "phrase_id": 15594,
      "text_uthmani": "إِنَّ ٱللَّهَ مَعَ ٱلصَّـٰبِرِينَ",
      "text_simple": "ان الله مع الصبرين",
      "source_key": "2:153",
      "from": 7,
      "to": 10
    }
  }
}

Input

Exactly one of:

• phrase_id (number, optional): Mutashabihat phrase ID.
• phrase_text (string, optional): Arabic phrase text to search.

Optional:

• same_surah_only (boolean, optional, default false): When true, limits results to same-surah occurrences.

Example User Prompts

• "Find where the phrase الرحمن الرحيم appears."
• "Show all matches for phrase ID 1452."
• "Find this phrase, but only within the same surah."

Example Request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "phrase_mutashabihat",
    "arguments": {
      "phrase_id": 1452,
      "same_surah_only": false
    }
  }
}