دستیارتان نرخ امروز را از خود ما بپرسد
این سرور یک کار میکند و همان را درست انجام میدهد: تابلوی نرخ ایرانیولت را در اختیار دستیار شما میگذارد. بعد از اتصال، دیگر لازم نیست نرخ را کپی کنید یا امیدوار باشید مدل عدد درستی به یاد داشته باشد — خودش میپرسد و جواب امروز را میگیرد.
- ابزارها
- ۲ ابزار
- دسترسی
- فقط خواندن
- احراز هویت
- لازم نیست
- تازگی نرخ
- هر ۱۰ دقیقه
این تنها چیزی است که باید کپی کنید
هرجا کلاینت شما آدرس سرور MCP میخواهد، همین را بگذارید. چیزی روی سیستم شما نصب نمیشود و فرایندی در پسزمینه نمیماند.
https://iraniwallet.com/api/v1/mcp/rates
کپی کنید و در تنظیمات کلاینتتان بگذارید؛ بقیهاش با خود کلاینت است.
در کلاینت خودتان
یکی از اینها را بردارید. اسم سرور (iraniwallet-rates) دلخواه است؛ همان اسمی است که بعداً در فهرست ابزارهای دستیارتان میبینید.
فایل .cursor/mcp.json در ریشهٔ پروژه (برای همان پروژه) یا ~/.cursor/mcp.json (برای همهٔ پروژهها). بعد از ذخیره، سرور در Settings › MCP با وضعیت سبز دیده میشود.
{
"mcpServers": {
"iraniwallet-rates": {
"url": "https://iraniwallet.com/api/v1/mcp/rates"
}
}
}
یک دستور در ترمینال، بیرون از جلسهٔ claude. با --scope user سرور برای همهٔ پروژههایتان ثبت میشود؛ بدون آن فقط برای پروژهٔ فعلی.
claude mcp add --transport http --scope user iraniwallet-rates https://iraniwallet.com/api/v1/mcp/rates # بررسی اینکه وصل شده claude mcp list
هر کلاینتی که ساختار استاندارد mcpServers را میخواند. اگر کلاینت شما فقط سرور محلی میشناسد و آدرس اینترنتی نمیپذیرد، نسخهٔ دوم پل mcp-remote را برایش میسازد.
{
"mcpServers": {
"iraniwallet-rates": {
"url": "https://iraniwallet.com/api/v1/mcp/rates"
}
}
}
// کلاینتهای قدیمیتر که فقط فرمان محلی میپذیرند:
{
"mcpServers": {
"iraniwallet-rates": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://iraniwallet.com/api/v1/mcp/rates"]
}
}
}
ببینید در عمل چه شکلی است
این همان چیزی است که بعد از اتصال میبینید: شما فارسی میپرسید، دستیار خودش سراغ تابلوی ما میرود، و جواب با نرخ همین لحظه برمیگردد.
همینجا امتحانش کنید
لازم نیست چیزی نصب کنید تا ببینید جواب سرور چه شکلی است. یکی از دکمهها را بزنید؛ دقیقاً همان چیزی فرستاده میشود که دستیار شما میفرستد.
- کد وضعیت
- —
- زمان پاسخ
- —
- سهمیهٔ باقیمانده
- —
{"base": "IRT","note": "نرخها به تومان برای هر یک واحد ارز است. buy نرخی است که ایرانی ولت بابت ارز میپردازد و sell نرخی است که بابت ارز میگیرد.","updatedAt": "2026-09-15T05:10:01+03:30","source": "https://iraniwallet.com/","documentation": "https://iraniwallet.com/api","rates": [{"code": "USDT","name": "تتر — TRC20 / ERC20","buy": "226478","sell": "227732","url": "https://iraniwallet.com/exchange/USDT"},{"code": "USD","name": "دلار آمریکا","buy": "226709","sell": "228425","url": "https://iraniwallet.com/exchange/USD"},{"code": "CAD","name": "دلار کانادا","buy": "163559","sell": "163657","url": "https://iraniwallet.com/exchange/CAD"},{"code": "AUD","name": "دلار استرالیا","buy": "162525","sell": "162623","url": "https://iraniwallet.com/exchange/AUD"},{"code": "EUR","name": "یورو","buy": "264132","sell": "262995","url": "https://iraniwallet.com/exchange/EUR"},{"code": "TRY","name": "لیر ترکیه","buy": "4616","sell": "4739","url": "https://iraniwallet.com/exchange/TRY"},{"code": "AED","name": "درهم امارات","buy": "62950","sell": "62950","url": "https://iraniwallet.com/exchange/AED"},{"code": "CNY","name": "یوان چین","buy": "34006","sell": "33933","url": "https://iraniwallet.com/exchange/CNY"},{"code": "AMD","name": "درام ارمنستان","buy": "636","sell": "626","url": "https://iraniwallet.com/exchange/AMD"}]}
این پاسخ همان چیزی است که دستیارتان میخواند. «فهرست ابزارها» از سهمیه کم نمیکند؛ فقط صدا زدن ابزار شمرده میشود.
دستیار شما به چه چیزهایی دسترسی دارد
دقیقاً همین دو تا، و هر دو فقط میخوانند. لازم نیست نامشان را حفظ کنید — دستیار خودش انتخاب میکند.
| ابزار | چهکار میکند |
|---|---|
get_rates
بدون ورودی
|
کل تابلو همهٔ ارزهایی که میز معاملات ما امروز میخرد و میفروشد، با نرخ خرید و فروش به تومان برای هر یک واحد و زمان ثبت نرخ. |
get_rate
code — کد ارز، مثل USD یا TRY
|
یک ارز همان داده، فقط برای ارزی که نامش را میبرید. اگر ارزی را بخواهید که معامله نمیکنیم، بهجای عدد ساختگی، فهرست چیزهایی که معامله میکنیم برمیگردد. |
چیزهایی که میتوانید بپرسید
هیچکدام از اینها دستور نیستند؛ جملهٔ عادیاند. دستیار خودش میفهمد که برای جواب دادن باید نرخ را بخواند.
- امروز خرید و فروش دلار چند است؟
- ۵۰۰ لیر ترکیه چقدر تومان میشود؟
- نرخ تتر و دلار را مقایسه کن و اختلافشان را بگو
- با ۱۰ میلیون تومان چند درهم میتوانم بخرم؟
- همهٔ نرخهای امروز را در یک جدول مرتب بنویس
- اسپرد خرید و فروش کدام ارز از همه کمتر است؟
اگر دستیار عددی گفت و اشارهای به زمان ثبت نرخ نکرد، از او بخواهید زمان را هم بگوید. هر پاسخ این سرور، زمان ثبت نرخ را با خودش دارد.
چیزهایی که باید بدانید
سرویس رایگان است و کلید نمیخواهد، اما بیقید نیست.
۱۰ بار صدا زدن ابزار در هر دقیقه
شمارش روی دقیقهٔ ساعت و بهازای هر آیپی است. دستدادن اولیهٔ کلاینت با سرور از این سهمیه کم نمیکند، پس یک گفتوگوی معمولی هیچوقت به سقف نمیخورد. اگر خورد، پاسخ ۴۲۹ با هدر Retry-After برمیگردد و دستیار به شما میگوید چند ثانیه باید صبر کند.
داده هر ۱۰ دقیقه ساخته میشود
پرسیدن پشتسرهم، عدد تازهتری به شما نمیدهد؛ همان تابلو برمیگردد. فیلد updatedAt میگوید میز معاملات آخرینبار کِی نرخ را ثبت کرده است.
نرخ اعلامی است، نه تعهد معامله
این عددها برای اطلاع و نمایشاند. نرخ نهایی هر معامله در پنل کاربری و در لحظهٔ ثبت سفارش تعیین میشود.
چیزهایی که معمولاً پرسیده میشود
بعد از اتصال، باید هر بار اسم ابزار را بنویسم؟
نه. سؤالتان را عادی بپرسید؛ دستیار از روی توضیح ابزار میفهمد که برای جواب دادن باید نرخ را بخواند. اسم ابزار فقط جایی به کار میآید که بخواهید صریح بگویید «از ایرانیولت بپرس».
این سرور به حساب کاربری یا پول من دسترسی دارد؟
نه. هر دو ابزار فقط تابلوی عمومی نرخ را میخوانند — همان چیزی که روی صفحهٔ اصلی سایت هم میبینید. چیزی ثبت نمیشود، سفارشی باز نمیشود و هیچ اتصالی به حساب شما وجود ندارد.
چرا دستیارم میگوید سرور را پیدا نمیکند؟
سه چیز را بررسی کنید: آدرس دقیقاً همان چیزی باشد که بالای صفحه نوشته شده، کلاینتتان MCP روی HTTP را پشتیبانی کند (نسخههای قدیمی فقط سرور محلی میشناسند و به mcp-remote نیاز دارند)، و بعد از ویرایش فایل تنظیمات، کلاینت را یکبار ببندید و باز کنید.
اگر ارزی را بپرسم که ندارید چه میشود؟
پاسخ خطای ابزار برمیگردد و در متنش نوشته میشود چه ارزهایی معامله میشوند. دستیار معمولاً همان را به شما میگوید یا خودش سراغ نزدیکترین گزینه میرود — بهجای اینکه عددی از خودش بسازد. با دکمهٔ «ارزی که معامله نمیکنیم» در بخش بالا میتوانید همین حالا ببینیدش.
فرقش با وبسرویس JSON شما چیست؟
داده یکی است و از یک تابلو خوانده میشود. تفاوت در این است که چه کسی درخواست را میزند: در وبسرویس، کدی که خودتان نوشتهاید؛ در MCP، دستیارتان، هر وقت که به داده نیاز داشت. اگر برنامه مینویسید، راهنمای وبسرویس را ببینید.
دادهای از من ذخیره میکنید؟
گفتوگوی شما با دستیارتان هیچوقت به ما نمیرسد؛ آنچه میرسد فقط همان صدا زدن ابزار است. مثل هر سرور دیگری، برای شمارش سهمیه آیپی درخواست دیده میشود و لاگ خطا نگه داشته میشود، و همین.