Map an ayah number

Converts an ayah number between riwayat and ayah-counting systems.

Technical namemap_ayah

Converts an ayah number between Hafs and another rawi (Warsh, Qalun, al-Bazzi, al-Duri and others), or between the six counting systems. It tells you when one ayah is split into two or two are counted as one. It returns numbers only, never text.

Try it in the demo Back to all tools

A real example

This is what the server actually returned for this call, unedited.

The call

map_ayah

surah: 1
ayah: 7
from: hafs
to: warsh

The result

From · Id: Hafs from Asim
From · Counting: kufi
From · Surah: 1
From · Ayah: 7
To · Id: Warsh from Nafi'
To · Counting: madani-last
To · Surah: 1
Relation: split

The full JSON result in the live demo

Captured from the server: 2026-11-12 · mutqin-mcp 0.3.0

The call as JSON

{
  "name": "map_ayah",
  "arguments": {
    "surah": 1,
    "ayah": 7,
    "from": "hafs",
    "to": "warsh"
  }
}

Parameters5 parameters

You never type these yourself: your assistant fills them in from your request. They are listed here for reference.

Name	Type	Default	Description
`surah`Required	`integer 1-114`	-	Surah number, 1 to 114.
`ayah`Required	`integer`	-	Ayah number in the "from" numbering.
`from`Required	`string`	-	Rawi or counting system to convert from, e.g. hafs, warsh, kufi or madani-last.
`to`Required	`string`	-	Rawi or counting system to convert to.
`numbering`Optional	`"associated" \| "printed"`	`"associated"`	Rawis only: associated (default) for the count linked to the qari, or printed for the printed mushaf's count. They differ for al-Duri and al-Susi.

Other tools in the Qiraat and ayah numbers group.

Try it yourself

Run this tool in the live demo, change its parameters and see the full result.