IraniWallet Currency Rates
Live buy and sell rates from IraniWallet in Iranian Toman — no API key, read-only
Documentation
این تنها چیزی است که باید کپی کنید
هرجا کلاینت شما آدرس سرور MCP میخواهد، همین را بگذارید. چیزی روی سیستم شما نصب نمیشود و فرایندی در پسزمینه نمیماند.
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 mcp add --transport http --scope user iraniwallet-rates https://iraniwallet.com/api/v1/mcp/rates
Added HTTP MCP server iraniwallet-rates with URL: https://iraniwallet.com/api/v1/mcp/rates to user config
claude
شما امروز نرخ دلار چند است؟
نرخ از ایرانیولت خوانده شد — ثبتشده در ۲۵ شهریور ۱۴۰۵، ساعت ۱۰:۳۰
دستیار خرید دلار ۲۲۶٬۵۱۲ تومان و فروش آن ۲۲۸٬۲۲۸ تومان است. این نرخ ایرانیولت است و در ۲۵ شهریور ۱۴۰۵، ساعت ۱۰:۳۰ ثبت شده.
شما ۵۰۰ دلار چقدر تومان میشود؟
دستیار با نرخ فروش ۲۲۸٬۲۲۸ تومان، ۵۰۰ دلار میشود ۱۱۴٬۱۱۴٬۰۰۰ تومان. نرخ نهایی هنگام ثبت سفارش در پنل تعیین میشود.
عددهای این نمایش ثابت نیستند؛ همین حالا از تابلوی ما خوانده شدهاند. صفحه را فردا باز کنید، نرخ فردا را میبینید.
همینجا امتحانش کنید
لازم نیست چیزی نصب کنید تا ببینید جواب سرور چه شکلی است. یکی از دکمهها را بزنید؛ دقیقاً همان چیزی فرستاده میشود که دستیار شما میفرستد.
{"base": "IRT","note": "نرخها به تومان برای هر یک واحد ارز است. buy نرخی است که ایرانی ولت بابت ارز میپردازد و sell نرخی است که بابت ارز میگیرد.","updatedAt": "2026-09-16T10:30:01+03:30","source": "https://iraniwallet.com/","documentation": "https://iraniwallet.com/api","rates": [{"code": "USDT","name": "تتر — TRC20 / ERC20","buy": "226282","sell": "227535","url": "https://iraniwallet.com/exchange/USDT"},{"code": "USD","name": "دلار آمریکا","buy": "226512","sell": "228228","url": "https://iraniwallet.com/exchange/USD"},{"code": "CAD","name": "دلار کانادا","buy": "163263","sell": "163362","url": "https://iraniwallet.com/exchange/CAD"},{"code": "AUD","name": "دلار استرالیا","buy": "162131","sell": "162229","url": "https://iraniwallet.com/exchange/AUD"},{"code": "EUR","name": "یورو","buy": "263835","sell": "262699","url": "https://iraniwallet.com/exchange/EUR"},{"code": "TRY","name": "لیر ترکیه","buy": "4606","sell": "4729","url": "https://iraniwallet.com/exchange/TRY"},{"code": "AED","name": "درهم امارات","buy": "62900","sell": "62900","url": "https://iraniwallet.com/exchange/AED"},{"code": "CNY","name": "یوان چین","buy": "33957","sell": "33884","url": "https://iraniwallet.com/exchange/CNY"},{"code": "AMD","name": "درام ارمنستان","buy": "635","sell": "625","url": "https://iraniwallet.com/exchange/AMD"}]}
این پاسخ همان چیزی است که دستیارتان میخواند. «فهرست ابزارها» از سهمیه کم نمیکند؛ فقط صدا زدن ابزار شمرده میشود.
دستیار شما به چه چیزهایی دسترسی دارد
دقیقاً همین دو تا، و هر دو فقط میخوانند. لازم نیست نامشان را حفظ کنید — دستیار خودش انتخاب میکند.
| ابزار | چهکار میکند |
|---|---|
get_rates بدون ورودی | کل تابلو همهٔ ارزهایی که میز معاملات ما امروز میخرد و میفروشد، با نرخ خرید و فروش به تومان برای هر یک واحد و زمان ثبت نرخ. |
get_rate code — کد ارز، مثل USD یا TRY | یک ارز همان داده، فقط برای ارزی که نامش را میبرید. اگر ارزی را بخواهید که معامله نمیکنیم، بهجای عدد ساختگی، فهرست چیزهایی که معامله میکنیم برمیگردد. |
چیزهایی که میتوانید بپرسید
هیچکدام از اینها دستور نیستند؛ جملهٔ عادیاند. دستیار خودش میفهمد که برای جواب دادن باید نرخ را بخواند.
- امروز خرید و فروش دلار چند است؟
- ۵۰۰ لیر ترکیه چقدر تومان میشود؟
- نرخ تتر و دلار را مقایسه کن و اختلافشان را بگو
- با ۱۰ میلیون تومان چند درهم میتوانم بخرم؟
- همهٔ نرخهای امروز را در یک جدول مرتب بنویس
- اسپرد خرید و فروش کدام ارز از همه کمتر است؟
اگر دستیار عددی گفت و اشارهای به زمان ثبت نرخ نکرد، از او بخواهید زمان را هم بگوید. هر پاسخ این سرور، زمان ثبت نرخ را با خودش دارد.
چیزهایی که باید بدانید
سرویس رایگان است و کلید نمیخواهد، اما بیقید نیست.
۱۰ بار صدا زدن ابزار در هر دقیقه
شمارش روی دقیقهٔ ساعت و بهازای هر آیپی است. دستدادن اولیهٔ کلاینت با سرور از این سهمیه کم نمیکند، پس یک گفتوگوی معمولی هیچوقت به سقف نمیخورد. اگر خورد، پاسخ ۴۲۹ با هدر Retry-After برمیگردد و دستیار به شما میگوید چند ثانیه باید صبر کند.
داده هر ۱۰ دقیقه ساخته میشود
پرسیدن پشتسرهم، عدد تازهتری به شما نمیدهد؛ همان تابلو برمیگردد. فیلد updatedAt میگوید میز معاملات آخرینبار کِی نرخ را ثبت کرده است.
نرخ اعلامی است، نه تعهد معامله
این عددها برای اطلاع و نمایشاند. نرخ نهایی هر معامله در پنل کاربری و در لحظهٔ ثبت سفارش تعیین میشود.
چیزهایی که معمولاً پرسیده میشود
بعد از اتصال، باید هر بار اسم ابزار را بنویسم؟
نه. سؤالتان را عادی بپرسید؛ دستیار از روی توضیح ابزار میفهمد که برای جواب دادن باید نرخ را بخواند. اسم ابزار فقط جایی به کار میآید که بخواهید صریح بگویید «از ایرانیولت بپرس».
این سرور به حساب کاربری یا پول من دسترسی دارد؟
نه. هر دو ابزار فقط تابلوی عمومی نرخ را میخوانند — همان چیزی که روی صفحهٔ اصلی سایت هم میبینید. چیزی ثبت نمیشود، سفارشی باز نمیشود و هیچ اتصالی به حساب شما وجود ندارد.
چرا دستیارم میگوید سرور را پیدا نمیکند؟
سه چیز را بررسی کنید: آدرس دقیقاً همان چیزی باشد که بالای صفحه نوشته شده، کلاینتتان MCP روی HTTP را پشتیبانی کند (نسخههای قدیمی فقط سرور محلی میشناسند و به mcp-remote نیاز دارند)، و بعد از ویرایش فایل تنظیمات، کلاینت را یکبار ببندید و باز کنید.
اگر ارزی را بپرسم که ندارید چه میشود؟
پاسخ خطای ابزار برمیگردد و در متنش نوشته میشود چه ارزهایی معامله میشوند. دستیار معمولاً همان را به شما میگوید یا خودش سراغ نزدیکترین گزینه میرود — بهجای اینکه عددی از خودش بسازد. با دکمهٔ «ارزی که معامله نمیکنیم» در بخش بالا میتوانید همین حالا ببینیدش.
فرقش با وبسرویس JSON شما چیست؟
داده یکی است و از یک تابلو خوانده میشود. تفاوت در این است که چه کسی درخواست را میزند: در وبسرویس، کدی که خودتان نوشتهاید؛ در MCP، دستیارتان، هر وقت که به داده نیاز داشت. اگر برنامه مینویسید، راهنمای وبسرویس را ببینید.
دادهای از من ذخیره میکنید؟
گفتوگوی شما با دستیارتان هیچوقت به ما نمیرسد؛ آنچه میرسد فقط همان صدا زدن ابزار است. مثل هر سرور دیگری، برای شمارش سهمیه آیپی درخواست دیده میشود و لاگ خطا نگه داشته میشود، و همین.
این سرور را ایرانیولت ارائه میکند ساخته شده با ❤️ در ایرانیولت