MCP server

FarsiTools (paid)

dev.workers.johnaio281.farsi-tools/farsi-tools

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Persian and Iranian utilities for agents: Jalali dates, national ID, IBAN, holidays. Paid via x402.

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

27

Token cost

About 4,216 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http farsi-tools https://farsi-tools.johnaio281.workers.dev/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.farsi-tools]
url = "https://farsi-tools.johnaio281.workers.dev/mcp"

Gemini CLI

{"mcpServers":{"farsi-tools":{"httpUrl":"https://farsi-tools.johnaio281.workers.dev/mcp"}}}

Cursor

{"mcpServers":{"farsi-tools":{"url":"https://farsi-tools.johnaio281.workers.dev/mcp"}}}

VS Code

{"servers":{"farsi-tools":{"type":"http","url":"https://farsi-tools.johnaio281.workers.dev/mcp"}}}

Antigravity

agy mcp add farsi-tools https://farsi-tools.johnaio281.workers.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"farsi-tools","server_url":"https://farsi-tools.johnaio281.workers.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"farsi-tools","server_url":"https://farsi-tools.johnaio281.workers.dev/mcp"}

Tools

• fa_amountToWords ~144 tokens
  Write an amount of Iranian rial or toman out in Persian words (مبلغ به حروف), as required on Iranian cheques, invoices and contracts. Use it to render a payable amount for a Persian-speaking payer. Returns the amount spelled in Persian words with its unit. ($0.005 per call, USDC on Base)
• fa_digits ~157 tokens
  Convert the digits inside a string between Persian (۰-۹), Arabic-Indic (٠-٩) and ASCII (0-9) numeral systems, leaving the rest of the text untouched. Use it to make Persian text machine-readable or to render an ASCII number in Persian script. Returns the converted string. ($0.003 per call, USDC on B
• fa_fixRtl ~166 tokens
  Remove Unicode bidi control characters and repair the spacing around right-to-left punctuation. Use it to clean Persian or Arabic text that renders in the wrong order or shows stray markers. Returns the cleaned string. ($0.005 per call, USDC on Base)
• fa_gregorianToJalali ~171 tokens
  Convert a Gregorian (ISO, Western) calendar date to the Jalali, Solar Hijri, Persian or Shamsi calendar used in Iran. Use it to display a date to Iranian users, to schedule work in the Iranian calendar, or to convert a Gregorian deadline into a Jalali date. Returns the Jalali year, month, day and mo
• fa_iranCity ~154 tokens
  Look up an Iranian city by its Persian name and return the province it belongs to. Use it to resolve a city in an address or to group a location by region. Returns the city and its province. ($0.005 per call, USDC on Base)
• fa_iranHolidayCheck ~158 tokens
  Check whether a given Jalali (Solar Hijri) date is an Iranian public holiday and return the holiday's name if it is. Use it before booking, scheduling or sending a deadline-sensitive action on an Iranian working day. Returns whether it is a holiday and which one. ($0.005 per call, USDC on Base)
• fa_iranHolidays ~134 tokens
  Return the official Iranian public holidays for a Jalali (Solar Hijri) year, with each holiday's Gregorian date and name. Use it to plan delivery or support schedules around Iranian holidays, or to flag non-working days. Returns the holiday list. ($0.005 per call, USDC on Base)
• fa_iranProvince ~175 tokens
  Look up an Iranian province by its Persian name and return its capital and major cities. Use it to resolve a province in an address, to attach geographic context to a user, or to normalize a location field. Returns the province, its capital and its cities. ($0.005 per call, USDC on Base)
• fa_iranProvinces ~105 tokens
  List all 31 Iranian provinces with their capitals and major cities. Use it to populate a province dropdown, to build a location picker, or to validate a region name. Returns every province. ($0.003 per call, USDC on Base)
• fa_jalaliToGregorian ~174 tokens
  Convert a Jalali (Solar Hijri, Persian, Shamsi) calendar date to the Gregorian calendar. Use it to turn a date written in the Iranian calendar back into an ISO 8601 date, to check whether a Jalali date is today, or to compare an Iranian deadline with a Western one. Returns the Gregorian year, month,
• fa_keywords ~180 tokens
  Extract the frequent keywords from Persian text, filtering Persian and English stopwords and ranking by frequency. Use it to build a search index, an automatic tag list, or a topic summary for a Persian document. Returns the ranked keywords. ($0.01 per call, USDC on Base)
• fa_normalize ~187 tokens
  Normalize Persian (Farsi) text: convert Arabic letter variants (ي, ك) to their Persian forms, unify ZWNJ and spacing, and map Arabic-Indic digits to Persian digits. Use it before indexing, searching or comparing Persian text so that lookalike spellings match. Returns the normalized string. ($0.01 pe
• fa_numberToWords ~143 tokens
  Write an integer out in Persian words (عدد به حروف), for example 1234 as هزار و دویست و سی و چهار. Use it for Persian invoices, cheque amounts, legal and official forms, and display. Returns the number spelled in Persian words. ($0.01 per call, USDC on Base)
• fa_rialToman ~125 tokens
  Convert an amount between Iranian rial and toman, where 1 toman equals 10 rial. Use it when a price is given in one unit and must be shown or billed in the other. Returns the converted amount. ($0.003 per call, USDC on Base)
• fa_sentences ~177 tokens
  Split Persian text into sentences, handling the Persian question mark ؟, the exclamation mark, ellipsis … and abbreviation boundaries. Use it to chunk Persian text for summarization, translation or per-sentence processing. Returns the list of sentences. ($0.005 per call, USDC on Base)
• fa_similarity ~150 tokens
  Measure the similarity of two Persian strings as a trigram Jaccard score from 0 to 1. Use it to detect near-duplicate Persian text, deduplicate a corpus, or rank one Persian string against another. Returns the similarity score. ($0.01 per call, USDC on Base)
• fa_stats ~171 tokens
  Measure Persian text: character count, word count, line count and the number of ZWNJ half-space characters. Use it to size a Persian document, enforce a length limit, or report text statistics for Persian content. Returns a stats object. ($0.005 per call, USDC on Base)
• fa_stripHtml ~162 tokens
  Strip HTML tags and decode HTML entities out of a string, leaving the readable text behind. Use it to clean web pages or scraped content before feeding it to an agent or an index. Returns the plain text. ($0.005 per call, USDC on Base)
• fa_transliterate ~198 tokens
  Transliterate Persian, Dari or Arabic script into Latin letters, optionally as a URL slug. Use it to index Persian text in a Latin-keyword search engine, to build slugs for Persian titles, or to render Persian names in a Latin-only system. Returns the Latin transliteration and, when asked, the slug.
• fa_validateBankCard ~150 tokens
  Validate an Iranian bank card number, called a PAN (کارت بانکی), with the Luhn check digit, and return the issuing bank. Use it before charging a card or accepting card details from a customer. Returns validity, the masked number and the bank name. ($0.005 per call, USDC on Base)
• fa_validateCompanyId ~152 tokens
  Validate an Iranian company national ID (شناسه ملی اشخاص حقوقی, the 11-digit legal-entity identifier) by recomputing its check digit. Use it when onboarding a business customer or validating an Iranian legal entity. Returns validity and the parsed digits. ($0.005 per call, USDC on Base)
• fa_validateEconomicCode ~145 tokens
  Validate an Iranian economic code (کد اقتصادی, the 12-digit taxpayer identifier) by recomputing its check digit. Use it when validating the tax identifier on an Iranian invoice or a supplier record. Returns validity and the parsed digits. ($0.005 per call, USDC on Base)
• fa_validateLandline ~161 tokens
  Validate and normalize an Iranian landline number with its area code (021 for Tehran and so on) and resolve that area code to a city. Use it to verify a fixed-line contact or to route a support request to the right region. Returns validity, the normalized number, the area code and the city. ($0.005
• fa_validateMobile ~159 tokens
  Validate and normalize an Iranian mobile phone number, checking the operator prefix (MCI, Irancell, Rightel, Shatel) and the national format 09xxxxxxxxx. Use it to verify a phone number on a sign-up form or before sending an SMS. Returns validity, the normalized number and the operator. ($0.005 per
• fa_validateNationalId ~142 tokens
  Validate an Iranian national ID (کد ملی, code melli) by recomputing its check digit. Use it before accepting an identity number from a form, a customer, or an API payload. Returns whether the number is valid, and the parsed digits. ($0.005 per call, USDC on Base)
• fa_validatePostalCode ~138 tokens
  Validate an Iranian postal code (کد پستی, the 10-digit code) by recomputing its check digit. Use it before using a postal code for delivery or address validation. Returns validity, the normalized code and its province. ($0.005 per call, USDC on Base)
• fa_validateSheba ~138 tokens
  Validate an Iranian IBAN, called Sheba (شبا), with the ISO 13616 mod-97 check, and return the bank code. Use it before sending or crediting an Iranian bank transfer. Returns validity, the normalized IBAN and the bank identifier. ($0.005 per call, USDC on Base)

Browse

• Web search
• Calendars
• Booking and scheduling
• Legal research

Related MCP servers

• IranTools (paid)
  Persian and Iranian utilities for agents plus text tooling. Paid via x402 or MPP.
• Dadras — Iranian law (دادرس)
  95,000+ articles of Iranian law, a legal glossary and 8 Iranian legal calculators. Free.
• NetArz FX Rates
  Iranian rial/toman exchange rates (~30 currencies), conversion, history and gold. Free tier, no key.
• Nemotron ASR Streaming — Persian
  Streaming Persian (Farsi) speech recognition
• Pocket TTS Farsi
  Persian text-to-speech with voice cloning, on CPU
• چیستارا — Iranian Legal Corpus
  Search Iranian statutes, court rulings, advisory opinions and circulars, with legal calculators.
• Duo Data Utilities: IBAN, ISIN, VAT and Tax ID, Barcode, Timezone, Geo APIs
  IBAN, ISIN, VAT/tax ID, GTIN validation; timezone, geo, text, chain utilities. Pay per call
• Cbest Lighting
  Iranian lighting supplier directory: products, brands, and a bilingual Persian/English taxonomy.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.workers.johnaio281.farsi-tools/farsi-tools.svg)](https://aptlynx.net/servers/dev.workers.johnaio281.farsi-tools/farsi-tools)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents