Search / dev.workers.johnaio281.farsi-tools/farsi-tools
protogridR0· no sign-inPersian and Iranian utilities for agents: Jalali dates, national ID, IBAN, holidays. Paid via x402.
v1.8.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"farsi-tools": {
"type": "http",
"url": "https://farsi-tools.johnaio281.workers.dev/mcp"
}
}
}claude mcp add --transport http farsi-tools https://farsi-tools.johnaio281.workers.dev/mcp[mcp_servers.farsi-tools]
url = "https://farsi-tools.johnaio281.workers.dev/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"farsi-tools": {
"type": "remote",
"url": "https://farsi-tools.johnaio281.workers.dev/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"farsi-tools": {
"type": "http",
"url": "https://farsi-tools.johnaio281.workers.dev/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=farsi-tools&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmFyc2ktdG9vbHMuam9obmFpbzI4MS53b3JrZXJzLmRldi9tY3AifQ%3D%3D"
}{
"servers": {
"farsi-tools": {
"type": "http",
"url": "https://farsi-tools.johnaio281.workers.dev/mcp"
}
}
}{
"mcpServers": {
"farsi-tools": {
"httpUrl": "https://farsi-tools.johnaio281.workers.dev/mcp"
}
}
}extensions:
"farsi-tools":
enabled: true
name: "farsi-tools"
type: streamable_http
uri: "https://farsi-tools.johnaio281.workers.dev/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky onestools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: fa_iranHolidayCheck (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); fa_digits (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); fa_numberToWords (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 3,410 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes27 tool changes in 30 daysstability.rug_pull24 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagefa_rialTomanchangeddescriptionmeaning changedConvert an amount between Iranian rial and toman (1 toman = 10 rial) ($0.003 per call, USDC on Base)
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_amountToWordschangeddescriptionmeaning changedWrite a rial or toman amount in Persian words (مبلغ به حروف) ($0.005 per call, USDC on Base)
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_iranHolidayCheckchangeddescriptionmeaning changedCheck whether a Jalali date is an Iranian public holiday and return its name ($0.005 per call, USDC on Base)
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_iranHolidayschangeddescriptionmeaning changedOfficial Iranian public holidays for a Jalali (Solar Hijri) year ($0.005 per call, USDC on Base)
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_iranProvinceschangeddescriptionList all 31 Iranian provinces with capitals and major cities ($0.003 per call, USDC on Base)
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_iranCitychangeddescriptionLook up an Iranian city and return the province it belongs to ($0.005 per call, USDC on Base)
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_iranProvincechangeddescriptionmeaning changedLook up an Iranian province by name with its capital and major cities ($0.005 per call, USDC on Base)
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_validateLandlinechangeddescriptionmeaning changedValidate and normalize an Iranian landline number and resolve its area code to a city ($0.005 per call, USDC on Base)
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 per call, USDC on Base)
fa_validatePostalCodechangeddescriptionmeaning changedValidate an Iranian postal code (کد پستی, 10 digits) ($0.005 per call, USDC on Base)
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_validateEconomicCodechangeddescriptionmeaning changedValidate an Iranian economic code (کد اقتصادی, 12 digits) ($0.005 per call, USDC on Base)
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)
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-97% +updated-9d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://farsi-tools.johnaio281.workers.dev/mcp streamable-http | none | yes | 97% | 2861 ms | 2025-11-25 | 2026-11-07 |
fa_amountToWords | 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 | 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 Base) |
fa_fixRtl | 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 | 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. ($0.005 per call, USDC on Base) |
fa_iranCity | 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 | 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 | 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 | 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 | 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 | 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. ($0.005 per call, USDC on Base) |
fa_keywords | 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 | 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 per call, USDC on Base) |
fa_numberToWords | 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 | 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 | 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 | 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 | 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 | 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 | 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. ($0.01 per call, USDC on Base) |
fa_validateBankCard | 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 | 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 | 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 | 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 per call, USDC on Base) |
fa_validateMobile | 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 call, USDC on Base) |
fa_validateNationalId | 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 | 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 | 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) |
Schemas: list_tools.
{
"name": "dev.workers.johnaio281.farsi-tools/farsi-tools",
"_meta": {},
"title": "FarsiTools (paid)",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://farsi-tools.johnaio281.workers.dev/mcp",
"type": "streamable-http"
}
],
"version": "1.8.0",
"repository": {
"url": "https://github.com/johnaio281/farsi-tools",
"source": "github"
},
"websiteUrl": "https://farsi-tools.johnaio281.workers.dev/",
"description": "Persian and Iranian utilities for agents: Jalali dates, national ID, IBAN, holidays. Paid via x402."
}