سرور 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 (وب و دسکتاپ)

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

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

claude_desktop_config.json

{
  "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

.cursor/mcp.json

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

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

با کلید پرو

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

Claude Code با کلید

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

Cursor با کلید

{
  "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 نرخ ارز برمی‌گردند.

اتصال به دستیار هوش مصنوعی (MCP)