Iranian rial/toman exchange rates (~30 currencies), conversion, history and gold. Free tier, no key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Convert an amount between any two currencies, Toman (IRT) or Rial (IRR; 1 Toman = 10 Rial), through the board's dollar rate. side=mid (default), buy or sell. تبدیل مبلغ بین دو ارز، تومان یا ریال با نرخ تابلو.
Currency code, or IRT (Toman) / IRR (Rial).
Currency code, or IRT (Toman) / IRR (Rial).
Amount of ONE unit of `from` (not the board's quote unit).
Convert an amount between any two currencies, Toman (IRT) or Rial (IRR; 1 Toman = 10 Rial), through the board's dollar rate. side=mid (default), buy or sell. تبدیل مبلغ بین دو ارز، تومان یا ریال با نرخ تابلو.
| Argument | Type | Description |
|---|---|---|
| to* | string | Currency code, or IRT (Toman) / IRR (Rial). |
| from* | string | Currency code, or IRT (Toman) / IRR (Rial). |
| side | string | |
| amount* | number | Amount of ONE unit of `from` (not the board's quote unit). |
{
"type": "object",
"required": [
"amount",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Currency code, or IRT (Toman) / IRR (Rial)."
},
"from": {
"type": "string",
"description": "Currency code, or IRT (Toman) / IRR (Rial)."
},
"side": {
"enum": [
"mid",
"buy",
"sell"
],
"type": "string",
"default": "mid"
},
"amount": {
"type": "number",
"description": "Amount of ONE unit of `from` (not the board's quote unit).",
"exclusiveMinimum": 0
}
}
}Global gold and silver ounce in USD, and Toman values of 18k gold per gram, mesghal and coins as NetArz publishes them. The Toman gold figures are COMPUTED from the ounce and the dollar — not the Tehran market price (no premium or making charge); say so when you quote them. انس طلا و نقره و ارزش محاسبه‌ای طلا به تومان (قیمت بازار تهران نیست).
No arguments.
{
"type": "object",
"properties": {}
}Daily Tehran open-market closing rate of a currency in Toman, with Gregorian and Jalali (Persian calendar) dates. Give `days` (back from today) or `from`/`to` (YYYY-MM-DD, Gregorian or Jalali such as 1404-01-01). Without a key: the last 365 days; a Pro FX API key reaches the whole archive (the dollar back to 1360 / 1981). At most 400 points per call; longer windows are sampled. نرخ پایانی روزانهٔ بازار آزاد با تاریخ شمسی و میلادی.
| Argument | Type | Description |
|---|---|---|
| to | string | End day, YYYY-MM-DD, Gregorian or Jalali. Default: today. |
| code* | string | ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD. |
| days | integer | Days back from today (default 30). Ignored when `from` is given. |
| from | string | Start day, YYYY-MM-DD, Gregorian or Jalali. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"to": {
"type": "string",
"description": "End day, YYYY-MM-DD, Gregorian or Jalali. Default: today."
},
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD."
},
"days": {
"type": "integer",
"maximum": 20000,
"minimum": 1,
"description": "Days back from today (default 30). Ignored when `from` is given."
},
"from": {
"type": "string",
"description": "Start day, YYYY-MM-DD, Gregorian or Jalali."
}
}
}Today's Tehran free-market rate of one currency in Toman (IRT): buy, sell and mid per quote unit, change against yesterday, and the time of the data. نرخ امروز یک ارز در بازار آزاد تهران به تومان: خرید، فروش، میانگین و تغییر نسبت به دیروز.
| Argument | Type | Description |
|---|---|---|
| code* | string | ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD."
}
}
}The whole board, or the codes you list, as structured rows plus a ready-to-show markdown table (buy / sell / mid in Toman, change vs yesterday). جدول نرخ همهٔ ارزها یا ارزهای انتخابی، با جدول markdown آماده.
| Argument | Type | Description |
|---|---|---|
| codes | array | Optional. Leave out for every currency. |
{
"type": "object",
"properties": {
"codes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD."
},
"maxItems": 40,
"description": "Optional. Leave out for every currency."
}
}
}Every currency on the NetArz Tehran free-market board: ISO code, Persian and English name, quote unit (some are quoted per 10 or 100 units) and its netarz.ir page. Pro-only currencies are listed with pro_only=true. فهرست ارزهای تابلوی نرخ نِت اَرز با واحد مظنه و نشانی صفحهٔ هر ارز.
No arguments.
{
"type": "object",
"properties": {}
}