# IranTools (paid) MCP server

Persian and Iranian utilities for agents plus text tooling. Paid via x402 or MPP.

## At a glance

IranTools (paid) is an MCP server in the AI & Memory category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 37 tools, including persian_normalize, persian_digits and number_to_words_fa. It scores B (65/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install IranTools (paid) in Claude Code

1. Add the server

```bash
claude mcp add --transport http irantools https://irantools.johnaio281.workers.dev/mcp
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. persian_normalize, persian_digits, number_to_words_fa). It discovers them automatically.

### How to install IranTools (paid) in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "irantools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://irantools.johnaio281.workers.dev/mcp"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install IranTools (paid) in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "irantools": {
      "url": "https://irantools.johnaio281.workers.dev/mcp"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install IranTools (paid) in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.irantools]
command = "npx"
args = ["-y", "mcp-remote", "https://irantools.johnaio281.workers.dev/mcp"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install IranTools (paid) in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "irantools": {
      "serverUrl": "https://irantools.johnaio281.workers.dev/mcp"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install IranTools (paid) in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "irantools": {
      "type": "streamableHttp",
      "url": "https://irantools.johnaio281.workers.dev/mcp"
    }
  }
}
```

### How to install IranTools (paid) in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "irantools": {
      "type": "http",
      "url": "https://irantools.johnaio281.workers.dev/mcp"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `persian_normalize` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian text sanitizer, Farsi normalizer, Arabic character unification, ZWNJ cleanup Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/persian_normalize Summary: Normalize Persian text: unify Ar
- `persian_digits` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian numeral converter, Arabic-Indic digit converter Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/persian_digits Summary: Convert digits between Persian/Arabic-Indic and ASCII. direction
- `number_to_words_fa` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian number-to-words, Farsi cheque amount, invoice amount in words Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/number_to_words_fa Summary: Spell a number out in Persian words, e.g. 1250
- `gregorian_to_jalali` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Gregorian to Persian date, Solar Hijri converter, Jalali calendar Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/gregorian_to_jalali Summary: Convert a Gregorian date to the Iranian Jalali (S
- `jalali_to_gregorian` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Jalali to Gregorian, Persian to Western date Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/jalali_to_gregorian Summary: Convert a Jalali (Solar Hijri) date to the Gregorian calendar. Keyword
- `iran_national_id` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian national ID validator, Code Melli check, Iran identity number Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_national_id Summary: Validate an Iranian national ID (کد ملی) with the o
- `iran_sheba` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: SHEBA validator, Iranian IBAN check, IRAN IBAN Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_sheba Summary: Validate an Iranian SHEBA (IRAN IBAN) account number with both IBAN mod-97 and I
- `iran_mobile` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iran mobile validator, Iran carrier lookup, MCI Irancell MTN Rightel Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_mobile Summary: Validate an Iranian mobile number (09xxxxxxxxx) and repor
- `iran_bank_card` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian PAN validator, Bank Melli card check, Iran card issuer lookup Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_bank_card Summary: Validate an Iranian bank card number (16-digit PAN) w
- `iran_company_id` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian company ID validator, Shenase Melli checker Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_company_id Summary: Validate an Iranian company registration id (شناسه ملی اشخاص حقوقی). K
- `iran_economic_code` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian economic code validator, Kode Eghtesadi checker Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_economic_code Summary: Validate an Iranian economic code (کد اقتصادی) with its control
- `iran_postal_code` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian postcode validator, Postal code lookup Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_postal_code Summary: Validate an Iranian postal code (10 digits) and, when recognised, report t
- `iran_landline` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian landline validator, Area code lookup Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_landline Summary: Validate an Iranian landline number (0xx) and report its area code and city. Ke
- `iran_province` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iran province lookup, Ostan directory Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_province Summary: Look up an Iranian province by Persian or English name and return its code, capital an
- `iran_city` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iran city lookup, Shahr directory Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_city Summary: Look up an Iranian city by Persian or English name and return its province and region. Keyword
- `iran_provinces_list` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iran province directory, Ostan list Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_provinces_list Summary: List all 31 Iranian provinces with their codes, capitals and regions. Keyword: lis
- `iran_holidays` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian public holiday calendar, Jalali holiday list, Nowruz calendar Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_holidays Summary: List the official Iranian public holidays for a Jalali
- `iran_holiday_check` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian holiday checker, Public holiday lookup Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_holiday_check Summary: Check whether a Gregorian date is an Iranian public holiday, and name it
- `iran_amount_to_words` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian amount-to-words, Toman/Rial in words Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_amount_to_words Summary: Spell an amount in Persian words with the correct unit (toman or rial). 
- `rial_toman_convert` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Rial/Toman converter, Iranian unit converter Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/rial_toman_convert Summary: Convert between Iranian rial and toman (1 toman = 10 rial). Keyword: rial 
- `persian_keywords` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian keyword extractor, Farsi topic extractor Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/persian_keywords Summary: Extract the most frequent meaningful keywords from Persian text, with
- `persian_sentences` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian sentence splitter, Farsi text segmenter Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/persian_sentences Summary: Split Persian text into sentences. Keyword: split persian sentences K
- `persian_similarity` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Persian similarity score, Farsi duplicate detector Family key: irantools.johnaio281.workers.dev::persian Endpoint: POST /api/iran/persian_similarity Summary: Compute a 0-1 similarity score between two Persian strings using 
- `strip_html` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: HTML stripper, Markup cleaner Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/strip_html Summary: Remove HTML tags and decode entities from a string. Keyword: strip html Keyword: remove tags Keyw
- `fix_rtl` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: RTL fixer, Bidirectional text repair Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/fix_rtl Summary: Fix bidirectional text rendering in Persian/Arabic strings by isolating LTR runs. Keyword: fi
- `homoglyph_fold` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Homoglyph folder, Spoofed-domain detector, Confusable character mapper Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/homoglyph_fold Summary: Fold Unicode homoglyphs to ASCII to detect spoofed d
- `script_detect` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Unicode script detector, Mixed-script spoofing check Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/script_detect Summary: Detect which Unicode scripts a string uses and flag mixed-script spoofi
- `unicode_normalize` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Unicode normalizer, NFC/NFD converter Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/unicode_normalize Summary: Normalize text to NFC, NFD, NFKC or NFKD and report the first differing position. 
- `grapheme_count` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Grapheme counter, Character length counter Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/grapheme_count Summary: Count user-perceived characters (graphemes) versus code points, UTF-16 units and
- `describe_date` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Date describer, Calendar metadata Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/describe_date Summary: Describe a calendar date: weekday, ISO week, day of year, quarter, leap year, weekend. Key
- `business_days` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Business-day counter, Working-day calculator Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/business_days Summary: Count business days between two dates (weekends excluded). Keyword: business da
- `slugify` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Slug generator, Permalink builder, URL slugifier Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/slugify Summary: Convert a title into a clean URL slug with accent stripping and optional length l
- `fnv_hash` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: FNV-1a hasher, Content fingerprint Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/fnv_hash Summary: Compute a stable FNV-1a content fingerprint (32 and 64 bit). Keyword: fnv1a Keyword: fnv hash 
- `entropy` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Entropy calculator, Randomness scorer Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/entropy Summary: Shannon entropy of a string in bits per character. Keyword: shannon entropy Keyword: string 
- `detect_format` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Format detector, Identifier classifier Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/detect_format Summary: Detect the format of a string: uuid, email, url, ipv4, ipv6, jwt, iban, mac, semver a
- `detect_encoding` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Encoding detector, Byte-string classifier Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/detect_encoding Summary: Detect the encoding of a byte string: ascii, utf-8, utf-16, hex, base64, latin-1
- `human_bytes` — Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Byte-size formatter, Human-readable size Family key: irantools.johnaio281.workers.dev::text Endpoint: POST /api/iran/human_bytes Summary: Format a byte count as a human-readable size. Keyword: human readable bytes Keyword: 

Source repository: https://github.com/johnaio281/irantools.johnaio281.workers.dev

---

Source: https://mcp-skills-hub.vercel.app/mcps/dev-workers-johnaio281-irantools-irantools · MCP Skills Hub · data as of 2026-10-28T12:31:05Z