search_ayahs_text

Search Quran ayahs by Arabic text and return plain JSON (no UI widget).

Widget counterpart: ayah_search — same search logic, renders an interactive result list.

Use This When

• Preparatory step before calling play_ayahs, ayah_tafsir, or ayah_translation — search here, then pass the resolved keys to the next tool.
• Inline quoting of matching ayahs when no interactive display is needed.
• Answering factual questions about where phrases appear in the Quran as plain data.

For final visual presentation of search results, use ayah_search instead.

Input

Same as ayah_search:

• query (string, required, 1–500 chars): Arabic search query. Diacritics and punctuation are stripped automatically.
• max_results (integer, optional, 1–100, default 20): Maximum number of matching ayahs.

A numeric-only query matches ayahs by that ordinal number (e.g., "255" returns ayahs ending in :255).

Limits

• Query must be Arabic script — Latin-only queries return empty.
• Max 100 results per request.

Example User Prompts

• "What does the ayah containing 'الحمد لله' say?" (agent calls this, quotes the result inline)
• "Play the ayahs with 'الرحمن الرحيم'" (agent calls this → gets keys → play_ayahs)
• "Explain ayahs mentioning 'صراط'" (agent calls this → ayah_tafsir with resolved keys)

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_ayahs_text",
    "arguments": {
      "query": "الحمد لله",
      "max_results": 5
    }
  }
}

Typical Chaining

search_ayahs_text → resolve ayah_keys → play_ayahs
search_ayahs_text → resolve ayah_keys → ayah_tafsir
search_ayahs_text → inline quote in response