# Parsi MCP

An offline MCP server that hands your agent Jalali dates, Iranian validators, Persian text helpers and RTL frontend snippets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: amirjld
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/amirjld/parsi-mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/parsi-mcp

## What it does

Everything runs on your machine and no API key is involved. The server registers 56 tools: Jalali date conversion, formatting and parsing, month grids for date pickers, business days with Friday as the weekend, checks for national ID, Sheba, card number and mobile number, Persian text normalization with ZWNJ repair, digits and numbers spelled out in words, and province lookup with ISO 3166-2 codes.

A second block covers layout. It ships RTL guidelines as a prompt, starter markup and price-input snippets, CSS and Tailwind audits, converters to logical properties, and Persian font presets. The bundled `persian-rtl-frontend` skill nudges the agent to build interfaces right-to-left from the start.

Node.js 18 or newer is required. The README notes the npm package was not published yet, so `npx` may fail — build from source instead: `git clone`, `npm install`, `npm run build`, then point the config at `dist/index.js` with `node`. Bank BIN, Sheba, mobile prefix and province data cover only publicly confirmed entries, and the VAT helper asks you to pass the rate.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add parsi-mcp -- npx -y parsi-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add parsi-mcp -- npx -y parsi-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "parsi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "parsi-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "parsi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "parsi-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add parsi-mcp npx -y parsi-mcp
```

## When to use it
- convert a date to Jalali and back
- check a card number and Sheba before checkout
- normalize Persian text and fix ZWNJ
- build an RTL form with a price field and Persian digits
- count business days with Friday as the weekend

## Example prompts
- Build a Persian checkout page with a price field
- Validate the card number and Sheba in this form
- Show today's Jalali date and add 3 days to it

## Similar
- [better-layout](https://affpapa.org/en/nevibecode/skills/better-layout.md) — skill · 30800 installs
- [create-harness-spec](https://affpapa.org/en/nevibecode/skills/create-harness-spec.md) — skill · 465 installs
- [write-a-skill](https://affpapa.org/en/nevibecode/plugins/write-a-skill.md) — plugin · ★ 28786
- [localize](https://affpapa.org/en/nevibecode/skills/localize.md) — skill · 2700 installs
- [experience-lwc-rtl-validate](https://affpapa.org/en/nevibecode/skills/experience-lwc-rtl-validate.md) — skill · 2300 installs
- [localization-design](https://affpapa.org/en/nevibecode/skills/localization-design.md) — skill · 1700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md