NetArz FX Rates

Live Iranian rial/toman exchange rates (~30 currencies), conversion, daily history and gold prices. Remote server at https://netarz.ir/api/fx/mcp: free tier needs no key (15 min delay, 1 year history); full history is Pro only.

View on netarz.ir

Hosted MCP Server

npx add-mcp 'https://netarz.ir/api/fx/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

سرور MCP نرخ ارز نرخ‌های نِت اَرز را مستقیم در اختیار دستیار هوش مصنوعی شما می‌گذارد. وقتی از Claude، ChatGPT یا Cursor می‌پرسید «۵۰۰ دلار الان چند تومان است؟»، دستیار از همین سرور می‌پرسد و عدد را از بازار آزاد تهران می‌آورد، نه از حافظهٔ مدل. MCP (Model Context Protocol) استاندارد باز اتصال دستیارها به ابزار است و نشانی ما این است:

https://netarz.ir/api/fx/mcp

بدون کلید

برای شروع کلید لازم نیست. نشانی بالا را در برنامه‌تان اضافه کنید و بپرسید. بدون کلید نرخ‌ها ۱۵ دقیقه تأخیر دارند و تاریخچه یک سال اخیر را پوشش می‌دهد.

ابزارها

همهٔ ابزارها فقط می‌خوانند؛ چیزی ثبت یا خرج نمی‌کنند.

ابزارکارش
list_currenciesفهرست ارزهای تابلو، واحد مظنه (بعضی ارزها برای ۱۰ یا ۱۰۰ واحد قیمت دارند) و صفحهٔ هر ارز.
get_rateنرخ خرید، فروش و میانگین یک ارز به تومان، با تغییر نسبت به دیروز.
get_rates_tableجدول همهٔ ارزها یا چند ارز انتخابی، با جدول آمادهٔ markdown.
convertتبدیل مبلغ بین هر دو ارز، تومان یا ریال، با نرخ میانگین، خرید یا فروش.
get_historyنرخ پایانی روزانه با تاریخ شمسی و میلادی. بدون کلید یک سال اخیر؛ با کلید پرو کل آرشیو، دلار از ۱۳۶۰.
get_gold_pricesانس طلا و نقره به دلار و ارزش محاسبه‌ای طلای ۱۸ عیار و سکه به تومان.

ارزش طلا به تومان از انس جهانی و نرخ دلار محاسبه می‌شود و قیمت بازار تهران نیست؛ اجرت و حباب سکه را ندارد.

اتصال به برنامه‌ها

Claude Code

claude mcp add --transport http netarz-fx https://netarz.ir/api/fx/mcp

Claude (وب و دسکتاپ)

  1. Settings ← Connectors روی «Add custom connector» بزنید.
  2. نشانی را بدهید نام را NetArz FX بگذارید و نشانی https://netarz.ir/api/fx/mcp را بچسبانید. نیازی به ورود یا کلید نیست.

اگر نسخهٔ دسکتاپ شما فقط سرور محلی می‌پذیرد، این تنظیم در فایل claude_desktop_config.json همان کار را می‌کند (Node.js لازم است):

{
  "mcpServers": {
    "netarz-fx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://netarz.ir/api/fx/mcp"]
    }
  }
}

ChatGPT

در ChatGPT از Settings ← Connectors (در بعضی حساب‌ها پس از روشن کردن «Developer mode») یک اتصال تازه بسازید، نشانی بالا را بدهید و احراز هویت را «بدون احراز هویت (No authentication)» بگذارید. در دسترس بودن این بخش به طرح حساب ChatGPT شما بستگی دارد.

Cursor و VS Code

{
  "mcpServers": {
    "netarz-fx": {
      "url": "https://netarz.ir/api/fx/mcp"
    }
  }
}

در VS Code همین نشانی را با دستور «MCP: Add Server» و نوع HTTP اضافه کنید.

با کلید پرو

کلید اپ شما (fx-ntz-v1-…) همان کلید API نرخ ارز است و همان قاعده‌ها را دارد: قفل دامنه یا IP سرور، سهمیهٔ روزانه و محدودیت در دقیقهٔ طرح خودش. با کلید پرو نرخ‌ها بدون تأخیرند، کل آرشیو روزانه باز است و ارزهای ویژهٔ پرو (مثل سوم ازبکستان و سامانی تاجیکستان) هم پاسخ می‌دهند. کلید را در هدر Authorization بفرستید.

claude mcp add --transport http netarz-fx https://netarz.ir/api/fx/mcp \
  --header "Authorization: Bearer fx-ntz-v1-..."

{
  "mcpServers": {
    "netarz-fx": {
      "url": "https://netarz.ir/api/fx/mcp",
      "headers": { "Authorization": "Bearer fx-ntz-v1-..." }
    }
  }
}

قفل دامنه برای MCP هم برقرار است. برنامهٔ دسکتاپ یا مرورگر شما معمولاً از دامنهٔ اپ شما درخواست نمی‌فرستد؛ پس کلیدی که فقط به یک دامنه قفل است از آنجا رد می‌شود. برای ابزار روی لپ‌تاپ، IP ثابت را به اپ اضافه کنید. اگر کلید غلط باشد، سرور آن را بی‌صدا به حالت بدون کلید برنمی‌گرداند؛ خطا می‌گیرید.

محدودیت‌ها

  • بدون کلید: ۳۰۰ درخواست در دقیقه برای هر IP. با کلید: محدودیت دقیقهٔ طرح اپ.
  • خروجی همیشه JSON است و پیوند صفحهٔ همان ارز و زمان داده را دارد. هنگام نقل نرخ، نام نِت اَرز و پیوند را بیاورید.
  • نرخ‌ها نشانی‌اند، پیشنهاد خرید و فروش نیستند؛ نِت اَرز ارز نمی‌خرد و نمی‌فروشد.
  • اتصال بدون حالت است و رویداد زنده (SSE) ندارد؛ برای استریم از استریم زنده استفاده کنید.

امتحان با curl

curl https://netarz.ir/api/fx/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_rate","arguments":{"code":"USD"}}}'

خطاهای ابزار (مثل ارز ناشناخته یا ارز ویژهٔ پرو) با isError: true و همان کدهای API نرخ ارز برمی‌گردند.