{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_c3pcbse6vppr","handle":"farsi-tools","url":"https://wellknown.network/agents/farsi-tools","links":{"self":"https://wellknown.network/agents/farsi-tools/record.json","html":"https://wellknown.network/agents/farsi-tools","markdown":"https://wellknown.network/agents/farsi-tools/record.md","api":"https://wellknown.network/api/v1/agents/farsi-tools","status":"https://wellknown.network/api/v1/agents/farsi-tools/status","claim":"https://wellknown.network/agents/farsi-tools/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/farsi-tools/claim.json","badge":"https://wellknown.network/agents/farsi-tools/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/farsi-tools/history","tools":"https://wellknown.network/api/v1/agents/farsi-tools/tools"},"ard":{"identifier":"urn:air:farsi-tools.johnaio281.workers.dev:agent:farsi-tools","type":"application/a2a-agent-card+json"},"kind":"agent","declared":{"name":"farsi-tools","summary":"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 economi…","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. Also a fixed-price deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file, not per call.","publisher":{"name":"Hermes Agent","url":"https://farsi-tools.johnaio281.workers.dev"},"homepage":"https://farsi-tools.johnaio281.workers.dev","repository":null,"version":"1.0.0","license":null,"protocols":["a2a"],"tags":["paid","persian","iran","farsi","csv","cleanup"],"pricing":null,"endpoints":[{"url":"https://farsi-tools.johnaio281.workers.dev","type":"a2a","auth":"none","probeable":true}],"skills":[{"id":"normalize","name":"normalize","tags":["paid","persian","iran"],"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."},{"id":"transliterate","name":"transliterate","tags":["paid","persian","iran"],"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."},{"id":"stats","name":"stats","tags":["paid","persian","iran"],"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."},{"id":"digits","name":"digits","tags":["paid","persian","iran"],"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."},{"id":"number-to-words","name":"number-to-words","tags":["paid","persian","iran"],"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."},{"id":"gregorian-to-jalali","name":"gregorian-to-jalali","tags":["paid","persian","iran"],"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."},{"id":"jalali-to-gregorian","name":"jalali-to-gregorian","tags":["paid","persian","iran"],"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."},{"id":"validate-national-id","name":"validate-national-id","tags":["paid","persian","iran"],"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."},{"id":"validate-sheba","name":"validate-sheba","tags":["paid","persian","iran"],"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."},{"id":"validate-mobile","name":"validate-mobile","tags":["paid","persian","iran"],"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."},{"id":"keywords","name":"keywords","tags":["paid","persian","iran"],"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."},{"id":"sentences","name":"sentences","tags":["paid","persian","iran"],"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."},{"id":"similarity","name":"similarity","tags":["paid","persian","iran"],"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."},{"id":"strip-html","name":"strip-html","tags":["paid","persian","iran"],"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."},{"id":"fix-rtl","name":"fix-rtl","tags":["paid","persian","iran"],"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."},{"id":"validate-bank-card","name":"validate-bank-card","tags":["paid","persian","iran"],"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."},{"id":"validate-company-id","name":"validate-company-id","tags":["paid","persian","iran"],"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."},{"id":"validate-economic-code","name":"validate-economic-code","tags":["paid","persian","iran"],"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."},{"id":"validate-postal-code","name":"validate-postal-code","tags":["paid","persian","iran"],"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."},{"id":"validate-landline","name":"validate-landline","tags":["paid","persian","iran"],"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."},{"id":"iran-province","name":"iran-province","tags":["paid","persian","iran"],"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."},{"id":"iran-city","name":"iran-city","tags":["paid","persian","iran"],"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."},{"id":"iran-provinces","name":"iran-provinces","tags":["paid","persian","iran"],"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."},{"id":"iran-holidays","name":"iran-holidays","tags":["paid","persian","iran"],"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."},{"id":"iran-holiday-check","name":"iran-holiday-check","tags":["paid","persian","iran"],"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."},{"id":"amount-to-words","name":"amount-to-words","tags":["paid","persian","iran"],"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."},{"id":"rial-toman","name":"rial-toman","tags":["paid","persian","iran"],"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."},{"id":"cleanup-50","name":"cleanup-50","tags":["paid","persian","farsi","csv","cleanup"],"description":"Clean a Persian/Arabic CSV, TSV or text file of up to 50 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check."},{"id":"cleanup-500","name":"cleanup-500","tags":["paid","persian","farsi","csv","cleanup"],"description":"Clean a Persian/Arabic CSV, TSV or text file of up to 500 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check."},{"id":"cleanup-5000","name":"cleanup-5000","tags":["paid","persian","farsi","csv","cleanup"],"description":"Clean a Persian/Arabic CSV, TSV or text file of up to 5000 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check."}],"tools":["normalize","transliterate","stats","digits","number-to-words","gregorian-to-jalali","jalali-to-gregorian","validate-national-id","validate-sheba","validate-mobile","keywords","sentences","similarity","strip-html","fix-rtl","validate-bank-card","validate-company-id","validate-economic-code","validate-postal-code","validate-landline","iran-province","iran-city","iran-provinces","iran-holidays","iran-holiday-check","amount-to-words","rial-toman","cleanup-50","cleanup-500","cleanup-5000"],"extra":{"inputModes":["application/json"],"outputModes":["application/json"],"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"protocolVersion":"0.3.0"},"attribution":{"kind":"a2a_card","name":"a2a_card","summary":"a2a_card","version":"a2a_card","description":"a2a_card","homepageUrl":"a2a_card","publisherUrl":"a2a_card","publisherName":"a2a_card"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"declared"},{"slug":"finance.banking","name":"Banking","confidence":0.833,"provenance":"derived"},{"slug":"content.seo","name":"SEO","confidence":0.525,"provenance":"derived"}],"categories":["content","documents","finance"],"language":"en"},"observed":{"status":"live","statusReason":"Responded 6h ago.","lastOkAt":"2026-10-24T03:22:56.481Z","lastProbedAt":"2026-10-24T03:22:56.481Z","statusComputedAt":"2026-10-24T03:25:09.267Z","reliability30d":{"probes":8,"successRate":1,"p50Ms":43,"basis":"service","measures":{"availability":"availability","latency":"response time","tools":"tool surface observed","summary":"Checks reached the service itself."},"checks":{"total":8,"ok":8,"authBoundaryOk":0,"serviceOk":8,"note":"Counted from the observation rows for the window, checks of the server only (HTTP, A2A card, MCP initialize). ok = authBoundaryOk + serviceOk. `probes` is the sum of daily rollups and includes registry checks, so it can differ from `total`."}},"latestObservations":[{"at":"2026-10-24T03:22:56.481Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":42,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-23T21:26:47.288Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":41,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-23T15:31:55.670Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":39,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-23T09:30:07.508Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":3389,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-23T03:24:03.618Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":18,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-22T20:28:10.906Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":4562,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-22T13:29:31.819Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":47,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}},{"at":"2026-10-22T06:28:29.897Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":37,"error":null,"detail":{"name":"farsi-tools","signed":false,"version":"1.0.0","cardPath":"/.well-known/agent-card.json","skillCount":30,"protocolVersion":"0.3.0"}}],"tools":null,"package":null,"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"a2a_card","key":"https://farsi-tools.johnaio281.workers.dev/.well-known/agent-card.json","url":"https://farsi-tools.johnaio281.workers.dev/.well-known/agent-card.json","firstSeenAt":"2026-10-22T06:19:45.211Z","fetchedAt":"2026-10-22T06:19:45.211Z","normalizedAt":"2026-10-22T06:19:45.211Z"}]},"firstSeenAt":"2026-10-22T06:19:45.211Z","updatedAt":"2026-10-22T06:19:59.504Z"}