{"name":"farsi-tools","description":"Persian (Farsi) and Iranian utility API for AI agents: text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, and validators for Iranian national ID, SHEBA (IBAN), mobile, landline, postal code, bank card (Luhn PAN), company ID and economic code, plus province/city lookup, official Jalali holidays and Rial-Toman conversion.","version":"1.0.0","url":"https://farsi-tools.johnaio281.workers.dev","protocolVersion":"0.3.0","preferredTransport":"JSONRPC","defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"provider":{"organization":"Hermes Agent","url":"https://farsi-tools.johnaio281.workers.dev"},"payments":[{"rail":"x402","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","payTo":"0x326F9DBB7027F5aB8be9956353dFF62b6a05Dc29"},{"rail":"mpp","network":"eip155:4217","asset":"0x20c000000000000000000000b9537d11c60E8b50","assetSymbol":"USDC","payTo":"0x326F9DBB7027F5aB8be9956353dFF62b6a05Dc29"}],"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"skills":[{"id":"normalize","name":"normalize","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/normalize"]},{"id":"transliterate","name":"transliterate","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/transliterate"]},{"id":"stats","name":"stats","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/stats"]},{"id":"digits","name":"digits","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/digits"]},{"id":"number-to-words","name":"number-to-words","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/number-to-words"]},{"id":"gregorian-to-jalali","name":"gregorian-to-jalali","description":"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 month name.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/gregorian-to-jalali"]},{"id":"jalali-to-gregorian","name":"jalali-to-gregorian","description":"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, day and weekday.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/jalali-to-gregorian"]},{"id":"validate-national-id","name":"validate-national-id","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-national-id"]},{"id":"validate-sheba","name":"validate-sheba","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-sheba"]},{"id":"validate-mobile","name":"validate-mobile","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-mobile"]},{"id":"keywords","name":"keywords","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/keywords"]},{"id":"sentences","name":"sentences","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/sentences"]},{"id":"similarity","name":"similarity","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/similarity"]},{"id":"strip-html","name":"strip-html","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/strip-html"]},{"id":"fix-rtl","name":"fix-rtl","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/fix-rtl"]},{"id":"validate-bank-card","name":"validate-bank-card","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-bank-card"]},{"id":"validate-company-id","name":"validate-company-id","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-company-id"]},{"id":"validate-economic-code","name":"validate-economic-code","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-economic-code"]},{"id":"validate-postal-code","name":"validate-postal-code","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-postal-code"]},{"id":"validate-landline","name":"validate-landline","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/validate-landline"]},{"id":"iran-province","name":"iran-province","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/iran-province"]},{"id":"iran-city","name":"iran-city","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/iran-city"]},{"id":"iran-provinces","name":"iran-provinces","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/iran-provinces"]},{"id":"iran-holidays","name":"iran-holidays","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/iran-holidays"]},{"id":"iran-holiday-check","name":"iran-holiday-check","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/iran-holiday-check"]},{"id":"amount-to-words","name":"amount-to-words","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/amount-to-words"]},{"id":"rial-toman","name":"rial-toman","description":"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.","tags":["paid","persian","iran"],"examples":["https://farsi-tools.johnaio281.workers.dev/api/rial-toman"]}],"documentation":{"openapi":"https://farsi-tools.johnaio281.workers.dev/openapi.json","x402":"https://farsi-tools.johnaio281.workers.dev/.well-known/x402","mcp":"https://farsi-tools.johnaio281.workers.dev/mcp","skill":"https://farsi-tools.johnaio281.workers.dev/.well-known/skill.md","llms":"https://farsi-tools.johnaio281.workers.dev/llms.txt"},"securitySchemes":{}}