Telawa MCP — Quran for AI

Connect ChatGPT, Claude, Copilot and any MCP client to the Holy Quran. Live tools to read, search and cite the Quran, tafsir, duas, reciters and qibla — no API key required.

Free & open

No API key

Read-only

Hosted server — just paste the URL

https://telawa.org/api/mcp

Add this as a Server URL in your AI client. No install, no Node.js, no JSON.

Use cases

Cite verses accurately

Models stop hallucinating ayat — they fetch real Arabic text + translation.

Search the Quran

Full-text search across Arabic and 10+ translations from inside a chat.

Build Islamic assistants

Power custom GPTs / agents with tafsir, duas, reciters and qibla.

Daily verse & study

Random ayah, dhikr from Hisn al-Muslim, prayer/qibla helpers.

What the model can do

list_surahs— All 114 chapters with names + verse counts

get_surah— A full surah with ayahs and translation

get_ayah— A single verse, optional tafsir

random_ayah— A random verse for daily inspiration

search_quran— Full-text Arabic / translation search

list_reciters— Featured Quran reciters

list_duas / get_dua_category— Adhkar from Hisn al-Muslim

qibla— Kaaba bearing from any location

Local install (optional)

Prefer running it yourself? Add this to your Claude Desktop / VS Code config:

{
  "mcpServers": {
    "telawa": {
      "command": "npx",
      "args": ["-y", "telawa-mcp"]
    }
  }
}

REST API docs·View server manifest

FAQ

Do I need an API key?

No. It is free and open. The hosted URL works immediately; please attribute telawa.org.

Hosted vs local?

Hosted = paste the URL, zero install. Local = run via npx/node for offline or custom setups.

What data is it?

The same as our public API: Quran text, translations, tafsir, duas, reciters, qibla.

Is it read-only?

Yes. The MCP server only reads — it never modifies anything.