Tarteel MCP Server

io.github.tarteelai/tarteel-mcp-server

This connects Claude to Tarteel's Quran API over streamable HTTP, giving you programmatic access to translations, tafsir (exegesis), mutashabihat (similar verses), and recitation playlists. You get tools like ayah_translation, ayah_tafsir, and phrase_mutashabihat for content lookup, plus play_ayahs for building recitation playlists and prayer_times for Islamic prayer schedules. The server exposes both widget tools for rich responses and text-only variants for simpler output. Useful if you're building Islamic education features, need Quranic search in your assistant, or want to integrate prayer times and recitation without managing separate API clients. It's deployed at mcp.tarteel.ai and listed in ChatGPT's app directory with one-click setup.

tools: 16
transport: HTTP
last updated: Apr 21, 2026

Open website

Install

From registry metadata

$ npx add-mcp https://mcp.tarteel.ai/mcp --name tarteel

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http tarteel https://mcp.tarteel.ai/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 16 tools

Verified live against the running server on Nov 6, 2026.

ayah_mutashabihatShow repeated phrase metadata for one ayah with an interactive display. Use this when: the user asks which phrases in a specific ayah repeat elsewhere; the user needs phrase IDs and counts before calling phrase_mutashabihat.3 params

Show repeated phrase metadata for one ayah with an interactive display. Use this when: the user asks which phrases in a specific ayah repeat elsewhere; the user needs phrase IDs and counts before calling phrase_mutashabihat.

Parameters* required

ayah*integer

Ayah number within the selected surah.

same_surah_onlyvalue

When true, only include repeated phrase matches found in the same surah as the input ayah.

surah*integer

Surah number from 1 to 114.

phrase_mutashabihatShow phrase mutashabihat occurrences with an interactive display. Use this when: the user provides phrase text and asks where it appears; the user has a phrase_id (for example from ayah_mutashabihat) and wants all matches.3 params

Show phrase mutashabihat occurrences with an interactive display. Use this when: the user provides phrase text and asks where it appears; the user has a phrase_id (for example from ayah_mutashabihat) and wants all matches.

Parameters* required

phrase_idvalue

Mutashabihat phrase ID. Provide phrase_id or phrase_text, but not both.

phrase_textvalue

Arabic phrase text to search for. Provide phrase_text or phrase_id, but not both.

same_surah_onlyvalue

When true, only include occurrences from the same surah as each matched ayah.

ayah_translationDEFAULT tool for user-facing translation display. Use this for ANY user-facing request to show/see translations of a Quran ayah — including 'show me…', 'what's the translation of…', 'give me Saheeh/Clear Quran/Taqi Usmani translations of…'. This is the FINAL tool call for thes...1 params

DEFAULT tool for user-facing translation display. Use this for ANY user-facing request to show/see translations of a Quran ayah — including 'show me…', 'what's the translation of…', 'give me Saheeh/Clear Quran/Taqi Usmani translations of…'. This is the FINAL tool call for thes...

Parameters* required

queries*array

Translation queries. Each query defines an ayah range plus languages or slugs.

ayah_tafsirDEFAULT tool for user-facing tafsir display. Use this for ANY user-facing request to show/see tafsir commentary on a Quran ayah — including 'show me the tafsir of…', 'what does Ibn Kathir say about…', 'explain this ayah'. This is the FINAL tool call for these requests; do not...1 params

DEFAULT tool for user-facing tafsir display. Use this for ANY user-facing request to show/see tafsir commentary on a Quran ayah — including 'show me the tafsir of…', 'what does Ibn Kathir say about…', 'explain this ayah'. This is the FINAL tool call for these requests; do not...

Parameters* required

queries*array

Tafsir queries. Each query defines an ayah range plus tafsir slugs or languages.

ayah_searchDEFAULT tool for user-facing Quran search. Use this for ANY user-facing search — 'find ayahs that contain X', 'where does X appear in the Quran', 'search the Quran for X', or similar. This is the FINAL tool call for these requests; do not follow it with search_ayahs_text. Show...2 params

DEFAULT tool for user-facing Quran search. Use this for ANY user-facing search — 'find ayahs that contain X', 'where does X appear in the Quran', 'search the Quran for X', or similar. This is the FINAL tool call for these requests; do not follow it with search_ayahs_text. Show...

Parameters* required

max_resultsinteger

Maximum number of ayah results to return (1-100, default 20).default: 20

query*string

Search query in Arabic script. Diacritics and punctuation are stripped automatically; matching is diacritic-insensitive and ranked by BM25 relevance. Numeric fragments (e.g. '255') match ayahs with...

list_recitersDEFAULT tool for user-facing reciter-listing questions. Use this for ANY user-facing query like 'what reciters are available', 'who can recite for me', 'list Quran reciters'. This is the FINAL tool call for these requests; do not follow it with lookup_reciters. Shows the catal...

DEFAULT tool for user-facing reciter-listing questions. Use this for ANY user-facing query like 'what reciters are available', 'who can recite for me', 'list Quran reciters'. This is the FINAL tool call for these requests; do not follow it with lookup_reciters. Shows the catal...

No parameters. Call it with no arguments.

list_tafsirsDEFAULT tool for user-facing tafsir-listing questions. Use this for ANY user-facing query like 'what tafsirs are supported', 'list English tafsirs', 'which tafsir collections do you have'. This is the FINAL tool call for these requests; do not follow it with lookup_tafsirs. Sh...1 params

DEFAULT tool for user-facing tafsir-listing questions. Use this for ANY user-facing query like 'what tafsirs are supported', 'list English tafsirs', 'which tafsir collections do you have'. This is the FINAL tool call for these requests; do not follow it with lookup_tafsirs. Sh...

Parameters* required

languagesarray

Optional ISO 639-1 language code filters (for example ['en', 'ar']).

list_translationsDEFAULT tool for user-facing translation-listing questions. Use this for ANY user-facing query like 'what English translations are available', 'list French translations', 'which translators can I choose from'. This is the FINAL tool call for these requests; do not follow it wi...2 params

DEFAULT tool for user-facing translation-listing questions. Use this for ANY user-facing query like 'what English translations are available', 'list French translations', 'which translators can I choose from'. This is the FINAL tool call for these requests; do not follow it wi...

Parameters* required

languagestring

Optional ISO 639-1 language code filter (for example 'en'). Do not pass language names like 'english'.

localestring

Optional locale/language code for response localization (for example 'en' or 'ar').

play_ayahsPlay Quranic ayah audio with an interactive player widget. Use this when: the user asks to play/listen to ayahs. RECITER HANDLING: If the user names a specific reciter (e.g. 'Husary', 'Minshawi', 'Al-Afasy', 'Abdul Basit'), ALWAYS call lookup_reciters first to resolve the exac...2 params

Play Quranic ayah audio with an interactive player widget. Use this when: the user asks to play/listen to ayahs. RECITER HANDLING: If the user names a specific reciter (e.g. 'Husary', 'Minshawi', 'Al-Afasy', 'Abdul Basit'), ALWAYS call lookup_reciters first to resolve the exac...

Parameters* required

default_reciter_idinteger

Default reciter ID used when a query omits reciter_id.default: 20

queries*array

Audio playlist queries. Each query defines an ayah range and optional reciter.

prayer_timesGet Islamic prayer times for a city with an interactive timetable display. Use this when: the user asks for salah times in a location; the user asks to calculate times with a specific prayer method (for example ISNA or MWL).3 params

Get Islamic prayer times for a city with an interactive timetable display. Use this when: the user asks for salah times in a location; the user asks to calculate times with a specific prayer method (for example ISNA or MWL).

Parameters* required

city*string

City name for prayer time calculation (for example 'Cairo').

countrystring

Optional country name to disambiguate city lookup (for example 'Egypt').

methodstring

Prayer time calculation method (for example 'ISNA', 'MWL', or 'Makkah').one of MWL · ISNA · Egypt · Makkah · Karachi · Tehrandefault: ISNA

lookup_recitersINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what reciters are available' question — use list_reciters for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw...

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what reciters are available' question — use list_reciters for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw...

No parameters. Call it with no arguments.

lookup_tafsirsINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what tafsirs are supported' question — use list_tafsirs for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw d...1 params

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what tafsirs are supported' question — use list_tafsirs for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw d...

Parameters* required

languagesarray

Optional ISO 639-1 language code filters (for example ['en', 'ar']).

lookup_translationsINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what translations are available' question — use list_translations for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain te...2 params

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a 'what translations are available' question — use list_translations for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain te...

Parameters* required

languagestring

Optional ISO 639-1 language code filter (for example 'en'). Do not pass language names like 'english'.

localestring

Optional locale/language code for response localization (for example 'en' or 'ar').

get_translation_textINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to any 'show me / what's the translation of…' request — use ayah_translation for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for pla...1 params

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to any 'show me / what's the translation of…' request — use ayah_translation for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for pla...

Parameters* required

queries*array

Translation queries. Each query defines an ayah range plus languages or slugs.

get_tafsir_textINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to any 'show me / explain with tafsir…' request — use ayah_tafsir for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / r...1 params

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to any 'show me / explain with tafsir…' request — use ayah_tafsir for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / r...

Parameters* required

queries*array

Tafsir queries. Each query defines an ayah range plus tafsir slugs or languages.

search_ayahs_textINTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a search query — use ayah_search for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw results / no widget, OR (b)...2 params

INTERNAL/preparatory tool — text-only, no widget rendered. NEVER use as the user-facing answer to a search query — use ayah_search for that (the default interactive widget). Use this ONLY when EITHER (a) the user explicitly asks for plain text / raw results / no widget, OR (b)...

Parameters* required

max_resultsinteger

Maximum number of ayah results to return (1-100, default 20).default: 20

query*string

Details

Website: mcp.tarteel.ai/docs
Transport: HTTP
Registry: MCP registry, active
Resources: 20
Tools verified: Nov 6, 2026