Read Quran Today MCP
A public, read-only Model Context Protocol server providing access to the Madinah Mushaf Quran text, 127 translations, Tafsir, word-by-word analysis, and recitations. It allows AI agents to retrieve specific ayahs, search content, get tafsir, and list surahs, translations, and reciters without requiring user authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://readqurantoday.com/mcpWhat you can do with it
- Retrieve specific Quran ayahs and their translations
- Search Quran text and get Tafsir explanations
- Access word-by-word meanings and audio recitations
- List available surahs, translations, and reciters
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- readqurantoday 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 10 advertised
- Resources
- 115 advertised
- Resource templates
- 4 advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
get_ayah — Get ayahs
The Arabic of one ayah or a run of them (up to 50), with a translation. Defaults to the King Fahd Complex English (Hilali & Muhsin Khan).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"surah",
"ayah"
],
"properties": {
"to": {
"type": "integer",
"minimum": 1,
"description": "Last ayah, for a run; defaults to the first"
},
"ayah": {
"type": "integer",
"minimum": 1,
"description": "First ayah"
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1-114"
},
"translation": {
"type": "string",
"description": "Translation id, e.g. \"hilali\", \"sahih\", \"urdu_junagarhi\"; \"none\" for the Arabic alone"
}
},
"additionalProperties": false
}{
"title": "Get ayahs",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}search — Search the Quran
Ayahs containing the words given: in the Arabic (diacritics optional) or, with "translation", in that translation. Up to 50 results, each with its reference and link.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Default 10"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"translation": {
"type": "string",
"description": "Search this translation instead of the Arabic, e.g. \"hilali\""
}
},
"additionalProperties": false
}{
"title": "Search the Quran",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_tafsir — Get tafsir
The Tafsir al-Muyassar (King Fahd Complex, Arabic) of one ayah or a run of them, up to 50.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"surah",
"ayah"
],
"properties": {
"to": {
"type": "integer",
"minimum": 1
},
"ayah": {
"type": "integer",
"minimum": 1
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1-114"
}
},
"additionalProperties": false
}{
"title": "Get tafsir",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}word_by_word — Word by word
Each word of an ayah: its Latin reading and its meaning, in English or one of the other languages that have word meanings.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"surah",
"ayah"
],
"properties": {
"ayah": {
"type": "integer",
"minimum": 1
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1-114"
},
"language": {
"type": "string",
"description": "Language code for the meanings; default \"en\""
}
},
"additionalProperties": false
}{
"title": "Word by word",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_recitation — Get a recitation
The recording of a surah: a link to the MP3, its length, and where each ayah starts and ends, in seconds, with a link that starts at a given ayah, or plays a run of ayahs and stops.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"surah"
],
"properties": {
"to": {
"type": "integer",
"minimum": 1,
"description": "With ayah: the last ayah of a run to play, e.g. ayah 1 to 5"
},
"ayah": {
"type": "integer",
"minimum": 1,
"description": "An ayah to start the link at"
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1-114"
},
"reciter": {
"type": "string",
"description": "Reciter id; defaults to the site's own"
}
},
"additionalProperties": false
}{
"title": "Get a recitation",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_file — Get a file
Links to download a surah's files: "text", the Arabic (optionally with a translation and the Tafsir al-Muyassar) as a .txt; "audio", its recording as an MP3 (leave out the surah for all of a reciter's); "timing", where each ayah and word of a recording starts and ends, as JSON; "font", the mushaf's fonts for the surah's pages (QCF V2, one a page) with the glyphs each ayah is written in; "data", for developers, the whole data sets (the Uthmani text, a translation or the tafsir in one file, the mushaf layout, word by word), with their sources.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"text",
"audio",
"timing",
"font",
"data"
],
"type": "string"
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1-114; needed for all but audio"
},
"tafsir": {
"type": "boolean",
"description": "For text: the Tafsir al-Muyassar under each ayah"
},
"reciter": {
"type": "string",
"description": "For audio and timing: reciter id; defaults to the site's own"
},
"translation": {
"type": "string",
"description": "For text: a translation id to put under each ayah, e.g. \"hilali\"; for data: the translation to give whole"
}
},
"additionalProperties": false
}{
"title": "Get a file",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_surahs — List the surahs
All 114 surahs: number, names, ayah count and mushaf pages.
{
"type": "object",
"properties": {}
}{
"title": "List the surahs",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_translations — List the translations
The translations on offer, optionally for one language: id, language, translator. Also which languages have word-by-word meanings.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"language": {
"type": "string",
"description": "A language name or code to narrow to, e.g. \"urdu\" or \"ur\""
}
},
"additionalProperties": false
}{
"title": "List the translations",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_reciters — List the reciters
The recordings on offer: id, reciter, and what tells two recordings by one voice apart.
{
"type": "object",
"properties": {}
}{
"title": "List the reciters",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}send_feedback — Report a problem
Send the reader's report to readqurantoday.com: a problem with the site's text, a translation, the tafsir or a recitation, or a suggestion. Only when the reader asks to report or suggest something; send what they said, in their words, and the ayah or reciter it is about. Never on your own initiative.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"message"
],
"properties": {
"ayah": {
"type": "integer",
"minimum": 1
},
"kind": {
"enum": [
"bug",
"suggestion",
"feature",
"other"
],
"type": "string",
"description": "\"bug\" for something wrong"
},
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "Only if the reader gives it, for a reply"
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"message": {
"type": "string",
"maxLength": 2000,
"minLength": 10,
"description": "The report, in the reader's words"
},
"reciter": {
"type": "string",
"maxLength": 80,
"description": "Reciter id, for a problem with a recitation"
}
},
"additionalProperties": false
}{
"title": "Report a problem",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
115 advertised
player — Recitation player
Plays a surah, following each ayah in the Arabic as it is recited
ui://readqurantoday/player1. Al-Fatihah — A surah in Arabic
quran://surah/12. Al-Baqarah — A surah in Arabic
quran://surah/23. Ali 'Imran — A surah in Arabic
quran://surah/34. An-Nisa — A surah in Arabic
quran://surah/45. Al-Ma'idah — A surah in Arabic
quran://surah/56. Al-An'am — A surah in Arabic
quran://surah/67. Al-A'raf — A surah in Arabic
quran://surah/78. Al-Anfal — A surah in Arabic
quran://surah/89. At-Tawbah — A surah in Arabic
quran://surah/910. Yunus — A surah in Arabic
quran://surah/1011. Hud — A surah in Arabic
quran://surah/1112. Yusuf — A surah in Arabic
quran://surah/1213. Ar-Ra'd — A surah in Arabic
quran://surah/1314. Ibrahim — A surah in Arabic
quran://surah/1415. Al-Hijr — A surah in Arabic
quran://surah/1516. An-Nahl — A surah in Arabic
quran://surah/1617. Al-Isra — A surah in Arabic
quran://surah/1718. Al-Kahf — A surah in Arabic
quran://surah/1819. Maryam — A surah in Arabic
quran://surah/1920. Taha — A surah in Arabic
quran://surah/2021. Al-Anbya — A surah in Arabic
quran://surah/2122. Al-Hajj — A surah in Arabic
quran://surah/2223. Al-Mu'minun — A surah in Arabic
quran://surah/2324. An-Nur — A surah in Arabic
quran://surah/2425. Al-Furqan — A surah in Arabic
quran://surah/2526. Ash-Shu'ara — A surah in Arabic
quran://surah/2627. An-Naml — A surah in Arabic
quran://surah/2728. Al-Qasas — A surah in Arabic
quran://surah/2829. Al-'Ankabut — A surah in Arabic
quran://surah/2930. Ar-Rum — A surah in Arabic
quran://surah/3031. Luqman — A surah in Arabic
quran://surah/3132. As-Sajdah — A surah in Arabic
quran://surah/3233. Al-Ahzab — A surah in Arabic
quran://surah/3334. Saba — A surah in Arabic
quran://surah/3435. Fatir — A surah in Arabic
quran://surah/3536. Ya-Sin — A surah in Arabic
quran://surah/3637. As-Saffat — A surah in Arabic
quran://surah/3738. Sad — A surah in Arabic
quran://surah/3839. Az-Zumar — A surah in Arabic
quran://surah/3940. Ghafir — A surah in Arabic
quran://surah/4041. Fussilat — A surah in Arabic
quran://surah/4142. Ash-Shuraa — A surah in Arabic
quran://surah/4243. Az-Zukhruf — A surah in Arabic
quran://surah/4344. Ad-Dukhan — A surah in Arabic
quran://surah/4445. Al-Jathiyah — A surah in Arabic
quran://surah/4546. Al-Ahqaf — A surah in Arabic
quran://surah/4647. Muhammad — A surah in Arabic
quran://surah/4748. Al-Fath — A surah in Arabic
quran://surah/4849. Al-Hujurat — A surah in Arabic
quran://surah/4950. Qaf — A surah in Arabic
quran://surah/5051. Adh-Dhariyat — A surah in Arabic
quran://surah/5152. At-Tur — A surah in Arabic
quran://surah/5253. An-Najm — A surah in Arabic
quran://surah/5354. Al-Qamar — A surah in Arabic
quran://surah/5455. Ar-Rahman — A surah in Arabic
quran://surah/5556. Al-Waqi'ah — A surah in Arabic
quran://surah/5657. Al-Hadid — A surah in Arabic
quran://surah/5758. Al-Mujadila — A surah in Arabic
quran://surah/5859. Al-Hashr — A surah in Arabic
quran://surah/5960. Al-Mumtahanah — A surah in Arabic
quran://surah/6061. As-Saf — A surah in Arabic
quran://surah/6162. Al-Jumu'ah — A surah in Arabic
quran://surah/6263. Al-Munafiqun — A surah in Arabic
quran://surah/6364. At-Taghabun — A surah in Arabic
quran://surah/6465. At-Talaq — A surah in Arabic
quran://surah/6566. At-Tahrim — A surah in Arabic
quran://surah/6667. Al-Mulk — A surah in Arabic
quran://surah/6768. Al-Qalam — A surah in Arabic
quran://surah/6869. Al-Haqqah — A surah in Arabic
quran://surah/6970. Al-Ma'arij — A surah in Arabic
quran://surah/7071. Nuh — A surah in Arabic
quran://surah/7172. Al-Jinn — A surah in Arabic
quran://surah/7273. Al-Muzzammil — A surah in Arabic
quran://surah/7374. Al-Muddaththir — A surah in Arabic
quran://surah/7475. Al-Qiyamah — A surah in Arabic
quran://surah/7576. Al-Insan — A surah in Arabic
quran://surah/7677. Al-Mursalat — A surah in Arabic
quran://surah/7778. An-Naba — A surah in Arabic
quran://surah/7879. An-Nazi'at — A surah in Arabic
quran://surah/7980. 'Abasa — A surah in Arabic
quran://surah/8081. At-Takwir — A surah in Arabic
quran://surah/8182. Al-Infitar — A surah in Arabic
quran://surah/8283. Al-Mutaffifin — A surah in Arabic
quran://surah/8384. Al-Inshiqaq — A surah in Arabic
quran://surah/8485. Al-Buruj — A surah in Arabic
quran://surah/8586. At-Tariq — A surah in Arabic
quran://surah/8687. Al-A'la — A surah in Arabic
quran://surah/8788. Al-Ghashiyah — A surah in Arabic
quran://surah/8889. Al-Fajr — A surah in Arabic
quran://surah/8990. Al-Balad — A surah in Arabic
quran://surah/9091. Ash-Shams — A surah in Arabic
quran://surah/9192. Al-Layl — A surah in Arabic
quran://surah/9293. Ad-Duhaa — A surah in Arabic
quran://surah/9394. Ash-Sharh — A surah in Arabic
quran://surah/9495. At-Tin — A surah in Arabic
quran://surah/9596. Al-'Alaq — A surah in Arabic
quran://surah/9697. Al-Qadr — A surah in Arabic
quran://surah/9798. Al-Bayyinah — A surah in Arabic
quran://surah/9899. Az-Zalzalah — A surah in Arabic
quran://surah/99100. Al-'Adiyat — A surah in Arabic
quran://surah/100101. Al-Qari'ah — A surah in Arabic
quran://surah/101102. At-Takathur — A surah in Arabic
quran://surah/102103. Al-'Asr — A surah in Arabic
quran://surah/103104. Al-Humazah — A surah in Arabic
quran://surah/104105. Al-Fil — A surah in Arabic
quran://surah/105106. Quraysh — A surah in Arabic
quran://surah/106107. Al-Ma'un — A surah in Arabic
quran://surah/107108. Al-Kawthar — A surah in Arabic
quran://surah/108109. Al-Kafirun — A surah in Arabic
quran://surah/109110. An-Nasr — A surah in Arabic
quran://surah/110111. Al-Masad — A surah in Arabic
quran://surah/111112. Al-Ikhlas — A surah in Arabic
quran://surah/112113. Al-Falaq — A surah in Arabic
quran://surah/113114. An-Nas — A surah in Arabic
quran://surah/114surah — A surah in Arabic
quran://surah/{surah}translation — A surah in a translation
quran://translation/{id}/{surah}tafsir — A surah's Tafsir al-Muyassar
quran://tafsir/{surah}recitation — A recording of a surah: its link and timings
quran://recitation/{reciter}/{surah}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 915 ms
- 95th percentile latency
- 915 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 915 ms · metadata changed · 10 tool(s), 115 resource(s), 4 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http read-quran-today-mcp https://readqurantoday.com/mcpCodex
codex mcp add read-quran-today-mcp --url https://readqurantoday.com/mcpCursor
{
"mcpServers": {
"read-quran-today-mcp": {
"url": "https://readqurantoday.com/mcp"
}
}
}Cline
{
"mcpServers": {
"read-quran-today-mcp": {
"type": "streamableHttp",
"url": "https://readqurantoday.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"read-quran-today-mcp": {
"type": "http",
"url": "https://readqurantoday.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http read-quran-today-mcp https://readqurantoday.com/mcpClaude Desktop
{
"mcpServers": {
"read-quran-today-mcp": {
"url": "https://readqurantoday.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"read-quran-today-mcp": {
"serverUrl": "https://readqurantoday.com/mcp"
}
}
}Let your agent find its tools
Find servers like Read Quran Today MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Read Quran Today MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.