Skip to content

play_ayahs

Fetch Quranic ayah audio playlist data.

Widget Preview

play_ayahs widget preview in light modeplay_ayahs widget preview in dark mode

Input

  • queries (array, min 1, max 50)
  • default_reciter_id (number, optional, default 20)

Each query:

  • start_ayah ("surah:ayah")
  • end_ayah ("surah:ayah", optional)
  • reciter_id (number, optional)

Limits

  • Maximum 50 queries per call
  • Maximum 200 ayahs per request

Example User Prompts

  • "Play Surah Al-Fatiha (1:1-1:7)."
  • "Fetch audio for ayah 2:255 with reciter 20."
  • "Create a playlist for 18:1 to 18:5."

Example Request

json
{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "tools/call",
  "params": {
    "name": "play_ayahs",
    "arguments": {
      "default_reciter_id": 20,
      "queries": [
        {
          "start_ayah": "1:1",
          "end_ayah": "1:5",
          "reciter_id": 20
        }
      ]
    }
  }
}

Powered by