Tarteel MCP Server Docs

Appearance

Tools ​

All tools are called through:

  • POST https://mcp.tarteel.ai/mcp
  • JSON-RPC method: tools/call

Tool Catalog ​

Each tool page includes example user prompts you can paste directly into clients.

ayah_mutashabihat ​

  • What it does: Repeated phrase metadata for a single ayah.
  • Use this when: Find repeated phrases in one ayah, or get phrase IDs before phrase search.
  • Key input: surah, ayah, optional same_surah_only.
  • Limits: Single ayah lookup.
  • Details: /tools/ayah-mutashabihat

phrase_mutashabihat ​

  • What it does: Occurrences of a phrase across ayahs.
  • Use this when: Search by phrase text, or expand a known phrase_id to all matches.
  • Key input: Exactly one of phrase_id or phrase_text; optional same_surah_only.
  • Limits: Phrase lookup query.
  • Details: /tools/phrase-mutashabihat

ayah_translation ​

  • What it does: Translations for ayah ranges.
  • Use this when: Fetch non-Arabic translation text or use translator-specific slugs.
  • Key input: queries[] with start_ayah; optional end_ayah, languages, translations.
  • Limits: Max 50 queries; max 200 ayahs/request; max 10 translations/query.
  • Details: /tools/ayah-translation

ayah_tafsir ​

  • What it does: Tafsir for ayah ranges.
  • Use this when: Get explanation/commentary or retrieve tafsir by language/slug.
  • Key input: queries[] with start_ayah; optional end_ayah, tafsir_slugs, languages.
  • Limits: Max 20 queries; max 50 ayah+tafsir items/request.
  • Details: /tools/ayah-tafsir

list_reciters ​

  • What it does: Available Quran reciters.
  • Use this when: Discover reciter options or get IDs before play_ayahs.
  • Key input: No required args.
  • Limits: None.
  • Details: /tools/list-reciters

list_tafsirs ​

  • What it does: Available tafsirs, optionally filtered.
  • Use this when: Discover tafsir collections or get slugs before ayah_tafsir.
  • Key input: Optional languages.
  • Limits: None.
  • Details: /tools/list-tafsirs

list_translations ​

  • What it does: Callable translations with usable slugs, optionally filtered.
  • Use this when: Discover translation options or get slugs before ayah_translation.
  • Key input: Optional language, locale.
  • Limits: None.
  • Details: /tools/list-translations

play_ayahs ​

  • What it does: Audio playlist data for ayah ranges.
  • Use this when: Build recitation playlists or fetch reciter-specific audio URLs.
  • Key input: queries[]; optional default_reciter_id; each query supports optional end_ayah, reciter_id.
  • Limits: Max 50 queries; max 200 ayahs/request.
  • Details: /tools/play-ayahs

prayer_times ​

  • What it does: Prayer times for a city.
  • Use this when: Compute daily salah times or use a specific calculation method.
  • Key input: city; optional country, method.
  • Limits: Depends on city geocoding and calculation method.
  • Details: /tools/prayer-times

Powered by