Read Quran Today

Working · 3.1 s

com.readqurantoday/quranv1.0.0 Domain verified

The Quran (Madinah Mushaf): Arabic, 127 translations, tafsir, word by word and recitations

Research & Knowledge

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://readqurantoday.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_ayah Read-only

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).

ayahinteger, required

First ayah

surahinteger, required

Surah number, 1-114

tointeger

Last ayah, for a run; defaults to the first

translationstring

Translation id, e.g. "hilali", "sahih", "urdu_junagarhi"; "none" for the Arabic alone

Tools (10)

get_ayah

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).

read-only

Argument	Type	Description
to	integer	Last ayah, for a run; defaults to the first
ayah*	integer	First ayah
surah*	integer	Surah number, 1-114
translation	string	Translation id, e.g. "hilali", "sahih", "urdu_junagarhi"; "none" for the Arabic alone

Input schema (JSON)

{
  "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
}

get_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.

read-only

Argument	Type	Description
kind*	string
surah	integer	Surah number, 1-114; needed for all but audio
tafsir	boolean	For text: the Tafsir al-Muyassar under each ayah
reciter	string	For audio and timing: reciter id; defaults to the site's own
translation	string	For text: a translation id to put under each ayah, e.g. "hilali"; for data: the translation to give whole

Input schema (JSON)

{
  "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
}

get_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.

read-only

Argument	Type	Description
ayah	integer	An ayah to start the link at
surah*	integer	Surah number, 1-114
reciter	string	Reciter id; defaults to the site's own

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "surah"
  ],
  "properties": {
    "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
}

get_tafsir

The Tafsir al-Muyassar (King Fahd Complex, Arabic) of one ayah or a run of them, up to 50.

read-only

Argument	Type	Description
to	integer
ayah*	integer
surah*	integer	Surah number, 1-114

Input schema (JSON)

{
  "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
}

list_reciters

The recordings on offer: id, reciter, and what tells two recordings by one voice apart.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_surahs

All 114 surahs: number, names, ayah count and mushaf pages.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_translations

The translations on offer, optionally for one language: id, language, translator. Also which languages have word-by-word meanings.

read-only

Argument	Type	Description
language	string	A language name or code to narrow to, e.g. "urdu" or "ur"

Input schema (JSON)

{
  "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
}

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.

read-only

Argument	Type	Description
limit	integer	Default 10
query*	string
translation	string	Search this translation instead of the Arabic, e.g. "hilali"

Input schema (JSON)

{
  "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
}

send_feedback

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.

Argument	Type	Description
ayah	integer
kind*	string	"bug" for something wrong
email	string	Only if the reader gives it, for a reply
surah	integer
message*	string	The report, in the reader's words
reciter	string	Reciter id, for a problem with a recitation

Input schema (JSON)

{
  "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
}

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.

read-only

Argument	Type	Description
ayah*	integer
surah*	integer	Surah number, 1-114
language	string	Language code for the meanings; default "en"

Input schema (JSON)

{
  "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
}