NetArz FX Rates
Iranian rial/toman exchange rates (~30 currencies), conversion, history and gold. Free tier, no key.
Should I use this
Quality & Safety
Findings (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains zero-width or invisible Unicode characterin get_gold_prices
- LOWTool 'get_rate' description lacks action verbin get_rate
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"fx-rates": {
"url": "https://netarz.ir/api/fx/mcp"
}
}
}Remote endpoints
https://netarz.ir/api/fx/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢list_currencies
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. فهرست ارزهای تابلوی نرخ نِت اَرز با واحد مظنه و نشانی صفحهٔ هر ارز.
Input Schema
{
"type": "object",
"properties": {}
}🟢get_rate(code)
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. نرخ امروز یک ارز در بازار آزاد تهران به تومان: خرید، فروش، میانگین و تغییر نسبت به دیروز.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD."
}
},
"required": [
"code"
]
}🟢get_rates_table(codes)
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 آماده.
Input Schema
{
"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."
}
}
}🟢convert(amount, from, to, side)
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. تبدیل مبلغ بین دو ارز، تومان یا ریال با نرخ تابلو.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Amount of ONE unit of `from` (not the board's quote unit)."
},
"from": {
"type": "string",
"description": "Currency code, or IRT (Toman) / IRR (Rial)."
},
"to": {
"type": "string",
"description": "Currency code, or IRT (Toman) / IRR (Rial)."
},
"side": {
"type": "string",
"enum": [
"mid",
"buy",
"sell"
],
"default": "mid"
}
},
"required": [
"amount",
"from",
"to"
]
}🟢get_history(code, days, from, to)
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. نرخ پایانی روزانهٔ بازار آزاد با تاریخ شمسی و میلادی.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code, e.g. USD, EUR, AED, TRY, GBP, CNY, IQD."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 20000,
"description": "Days back from today (default 30). Ignored when `from` is given."
},
"from": {
"type": "string",
"description": "Start day, YYYY-MM-DD, Gregorian or Jalali."
},
"to": {
"type": "string",
"description": "End day, YYYY-MM-DD, Gregorian or Jalali. Default: today."
}
},
"required": [
"code"
]
}🟢get_gold_prices
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. انس طلا و نقره و ارزش محاسبه‌ای طلا به تومان (قیمت بازار تهران نیست).
Input Schema
{
"type": "object",
"properties": {}
}Community
Evidence