Give coding agents right-to-left awareness: lint, normalise Arabic, detect direction.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON βΎ
Client Config & Setup
Choose your client or environment
Target File:
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
rtl-mcp
An MCP server that gives a coding agent right-to-left awareness.
Ask an agent for a card component and you get ml-4 text-left β correct English, broken Arabic. The agent has no way to check itself, because nothing in its toolbox knows what RTL is. This gives it four tools that do.
Install
Point your MCP client at the package. Nothing to install first β npx fetches it.
Claude Code
Any client that reads an mcpServers block (Claude Desktop, Cursor, Windsurf, Zed):
Tools
| Tool | What the agent gets |
|---|---|
lint_rtl_code | Pass a snippet and a filename; get every physical CSS property, directional Tailwind utility and dir problem, each with its logical replacement. Powered by rtl-lint. |
lint_rtl_path | The same check across a file or a whole directory on disk. |
normalize_arabic | Fold the spellings users type interchangeably into one key β strips diacritics and tatweel, unifies the alef forms. For search and matching, not for display. |
detect_direction | Whether a string is rtl, ltr, mixed or neutral, and what to set dir to. |
Both lint tools accept baseDir: "rtl" for an Arabic-first app β see below.
Why normalize_arabic matters
Ω
ΩΨΩΩ
ΩΩΨ― and Ω
ΨΩ
Ψ― are the same name and different strings. So are Ψ£ΨΩ
Ψ― and Ψ§ΨΩ
Ψ―. A user who types their name without diacritics will not find their own record, and the bug reads like a broken database rather than a text problem.
The two folds that change meaning β Ω β Ω and Ψ© β Ω β are off by default. They widen fuzzy search and corrupt anything you display.
Pass baseDir: "rtl" for an Arabic-first app
Which logical side a physical one maps to depends on the document's base direction. In ltr, left is the start; in rtl, left is the end. So text-right in an English-first app becomes text-end, and in an app rooted at <html dir="rtl"> it becomes text-start β the opposite edge. Take the default on an Arabic app and the agent mirrors a working layout.
Utilities the author already scoped, like ltr:left-3 rtl:right-3, are left alone entirely.
Why detect_direction is not just a regex
Arabic-Indic digits (Ω’Ω Ω’Ω¦) live inside the Arabic Unicode block, so the obvious implementation calls them RTL. Under the bidirectional algorithm they are class AN, not AL β they never set the direction of a paragraph. Only strong letters vote here, so Ω’Ω Ω’Ω¦ comes back neutral and inherits its container's direction, which is what the spec says should happen.
Zero runtime dependencies
MCP over stdio is JSON-RPC 2.0, one message per line. The reference SDK brings seventeen transitive dependencies β Express, Hono, CORS, JOSE β none of which a stdio server uses. So the protocol layer here is written directly, and the only runtime dependency is rtl-lint.
That trade is only safe if conformance is proven rather than assumed. The test suite drives this server with the official SDK's client over a real stdio pipe. If the hand-written layer ever drifts from the specification, the reference implementation stops talking to it and CI goes red.
Protocol revisions understood: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. The server negotiates whichever one the client asks for.
Library use
The Arabic helpers work standalone, no MCP involved:
Requirements
Node.js 20 or newer. (Node 18 reached end of life in April 2025.)
License
MIT Β© Khalel Hawary
Related MCP Servers
Reviews
No reviews yet β be the first to share how this listing worked for you.
Frequently Asked Questions about RTL awareness for coding agents
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/rtl-awareness-for-coding-agents)HTML Embed
<a href="https://allmcps.com/mcp/rtl-awareness-for-coding-agents"><img src="https://allmcps.com/api/badge/rtl-awareness-for-coding-agents?style=directory" alt="RTL awareness for coding agents on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
36Quality signal: Fair Β· 36/100How this signal is calculated βΎ
Server availabilityNot measured
Not scored for repo-hosted servers β we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data β not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge β proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it β no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.