arabic_ordinal
Convert an integer to its Arabic ordinal words (e.g. 25 -> "الخامس والعشرون").
LABSCO SUMMARY
The details it gets right are the ones that are wrong nearly everywhere else.
The Saudi riyal has its own Unicode code point and is routinely emitted as the Iranian rial instead. Hijri output varies between Node, Chrome, Safari and Hermes. Arabic needs six plural forms and most libraries ship two. These are exactly the errors a model will produce confidently and nobody catches until something is printed.
What it is
An MCP wrapper around arabicfmt, a zero-dependency Arabic formatting library. It formats and spells currency, converts Gregorian dates to Hijri, writes numbers as Arabic words, picks the right plural form, repairs RTL sentences, and validates IBANs and Saudi IDs.
What you get
- Money — format_currency applies the correct symbol, grouping and decimal precision; spell_currency writes the full amount in Arabic words with the major and minor units in agreement
- Dates — format_hijri renders a Gregorian date with Arabic month names and era; to_hijri returns the year, month and day components
- Numbers — arabic_to_words, arabic_ordinal, format_number with optional Eastern Arabic numerals, format_compact with Arabic scale words, and parse_number which reads Latin or Eastern Arabic digits back into a number
- Time — format_duration writes a millisecond duration as natural Arabic; format_relative_time renders a date against a base date
- Language — arabic_plural selects from the six CLDR plural categories; transliterate maps Arabic to Latin script; slugify produces URL-safe slugs
- Layout — isolate_foreign wraps phone numbers, Latin text and URLs in Unicode bidi isolates so an RTL sentence stops breaking apart
- Validation — validate_iban checks the IBAN checksum and country length; validate_saudi_id checks the national or iqama check digit
Requirements
The arabicfmt-mcp npm package over stdio, registered as io.github.cc1a2b/arabicfmt-mcp. Node.js 18 or newer. No account, no key, no network — every answer is computed locally, and the underlying library has zero runtime dependencies.
Setup effort
One command — npx -y arabicfmt-mcp
USE CASES
01
Writing an amount on an Arabic invoice or cheque
The formatted figure with the right symbol and precision, and the same amount spelled out in words.
02
Showing a Hijri date that matches on every device
Frozen tables rather than the host engine's calendar, so the same date renders identically everywhere.
03
Stopping a phone number flipping mid-sentence
Wrap the Latin or numeric run in bidi isolates so the RTL sentence around it stays intact.
04
Reading Eastern Arabic digits a user typed
Parse a string with Arabic grouping and decimal separators back into a plain number.
05
Validating a bank account or national ID before submitting
Real checksums rather than a regex that accepts a well-shaped but invalid number.
06
Making a URL slug out of Arabic text
A slug that survives instead of stripping to empty or mojibake, with transliteration available separately.
17 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
arabic_plural
Select the correct Arabic plural form for a count from the six CLDR categories (e.g. 5 books -> "كتب"). Returns the chosen word.
arabic_to_words
Convert an integer to its full Arabic cardinal words (e.g. 1234567 -> "مليون ومئتان وأربعة وثلاثون ألفاً وخمسمئة وسبعة وستون").
format_compact
Format a number in compact notation with Arabic scale words (e.g. 1200000 with locale "ar" -> "1.2 مليون").
format_currency
Format a number as an Arabic currency amount with the correct symbol, grouping, and decimal precision (e.g. 1234.5 SAR -> "1,234.50 ر.س"). Handles the 2025-2026 Unicode currency-symbol transition (Saudi Riyal U+20C1, etc.).
format_duration
Format a duration in milliseconds as natural Arabic words (e.g. 7500000 -> "ساعتان وخمس دقائق").
format_hijri
Format a Gregorian date as a Hijri (Islamic) date string with Arabic month names and era (e.g. 2025-09-23 -> "٢٣ رمضان ١٤٤٧ هـ").
format_number
Format a number with locale-aware grouping, decimal separators, and optional Eastern Arabic numerals (e.g. 1234567.89 with numerals "arab" -> "١٬٢٣٤٬٥٦٧٫٨٩").
format_relative_time
Format a date relative to a base date in Arabic (e.g. three days ago -> "منذ ٣ أيام"). Defaults the base to now.
isolate_foreign
Wrap foreign/LTR runs (phone numbers, Latin text, URLs) inside Arabic text with Unicode bidi isolates so they render correctly in RTL contexts (e.g. "اتصل على +1 (555) 234-5678 الآن").
parse_number
Parse a string containing Latin or Eastern Arabic digits (with Arabic grouping/decimal separators) into a JavaScript number (e.g. "١٬٢٣٤٫٥٦" -> 1234.56). Returns the number as a string.
slugify
Convert Arabic (or mixed) text into a URL-safe slug (e.g. "مدينة جدة" -> "mdynh-jdh").
spell_currency
Spell out a currency amount in full Arabic words, including the major and minor units with correct grammatical agreement (e.g. 1234.5 SAR -> "ألف ومئتان وأربعة وثلاثون ريالاً وخمسون هللة").
to_hijri
Convert a Gregorian date to its Hijri components. Returns a JSON object string like {"year":1447,"month":9,"day":23}.
transliterate
Transliterate Arabic text to Latin script (e.g. "مُحَمَّد" -> "muhammad").
validate_iban
Validate an IBAN (International Bank Account Number) using its checksum and country length (e.g. "SA03 8000 0000 6080 1016 7519" -> "true"). Returns "true" or "false".
validate_saudi_id
Validate a Saudi national/iqama ID number using its Luhn-style checksum (e.g. "1012345672" -> "true"). Returns "true" or "false".
BEFORE YOU INSTALL
What to know first
Tools you get
17 tools when we connected. About 50 library functions, such as stripTashkeel and formatIBAN, are not exposed as MCP tools.
Requires
Node.js ≥ 18
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 17 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y arabicfmt-mcpMCP Clients
Claude Desktop, Claude Code, Cursor
JSON
{
"mcpServers": {
"arabicfmt": {
"command": "npx",
"args": [
"-y",
"arabicfmt-mcp"
]
}
}
}
