«موجودی حساب سواپولت من چقدر است؟»
get_total_balance
ارزش کل دارایی
تومان۱۲۵٬۲۱۳٬۷۹۰| ارز | مقدار | ارزش به تومان |
|---|---|---|
 تترUSDT | ۱۸۴٫۲ | تومان۴۷٬۰۸۱٬۳۳۶ |
 بیتکوینBTC | ۰٫۰۰۲۱ | تومان۴۴٬۷۴۰٬۵۹۶ |
 طلای پکسPAXG | ۰٫۰۲۱ | تومان۲۲٬۴۴۹٬۴۱۶ |
 تون‌کوینTON | ۳۱ | تومان۱۰٬۹۴۲٬۴۴۲ |
SwapWallet MCP Server سواپولت را به دستیار هوش مصنوعی‌تان وصل کنید
از داخل Claude، ChatGPT یا هر ابزاری که MCP را پشتیبانی میکند، موجودی و سود و زیان و تراکنش‌های سواپولتتان را ببینید و سواپ یا برداشت ثبت کنید. هیچ پولی بدون تأیید خودتان جابهجا نمیشود.
آدرس سرور
https://swapwallet.app/mcp- Claude
- ChatGPT
- Cursor
- Claude Code
- Gemini CLI
آخرین خبرهای بیتکوین را بررسی کن و بگو بیت‌کوینم را نگه دارم یا نه
Web Search("bitcoin news this week")
Did 1 search in 2s
swapwallet - get_balance (MCP)(tokens: ["BTC", "USDT"])
{"balance":{"IRT":"91821932","USD":"359.24"},
"tokens":[{"token":"BTC","amount":"0.0021",…},…]}
"tokens":[{"token":"BTC","amount":"0.0021",…},…]}
swapwallet - get_profit_and_loss (MCP)(tokens: ["BTC"])
{"items":[{"token":"BTC","weightedAveragePrice":{"USD":"76410"},
"unrealizedProfitAndLossPercent":{"USD":"9.1"},…}]}
"unrealizedProfitAndLossPercent":{"USD":"9.1"},…}]}
خبرها: این هفته خبر بد مهمی درباره‌ی خود بیتکوین نبود؛ بیشتر تیترها درباره‌ی ورود پول به ETFهای بیتکوین است.
موقعیت شما: ۰٫۰۰۲۱ بیتکوین، حدود ۴۴٫۷ میلیون تومان، با ۹٫۱٪ سود نسبت به میانگین خرید.
اگر بلندمدت نگهش می‌دارید، دلیلی برای فروش فوری نمی‌بینم. تصمیم با خودتان است؛ این توصیه‌ی سرمایه‌گذاری نیست.
با ۱۰۰ تتر دیگر بیتکوین بخر
swapwallet - request_swap (MCP)(sourceToken: "USDT", destinationToken: "BTC", amount: "100")
{"requestId":48213,"type":"SWAP","status":"PENDING","approvalChannel":"telegram",…}
درخواستش را ثبت کردم: ۱۰۰ تتر به حدود ۰٫۰۰۱۲ بیتکوین. پیامش به تلگرامتان رفت و تا ۱۵ دقیقه منتظر تأیید شماست.
swapwallet - get_action_request (MCP)(requestId: 48213)
{"requestId":48213,"type":"SWAP","status":"EXECUTED",…}
انجام شد. موجودی بیتکوین شما حالا ۰٫۰۰۳۳ است.
🤖 Claude Code درخواست انجام این عملیات روی حساب شما را دارد:
🔄 جزئیات تبدیل دارایی
• مبدأ: 100 تتر
• مقصد: 0.0011971 بیتکوین
✅ تاییدلغو
✅ تبدیل با موفقیت انجام شد
۱۰:۴۲مدیریت ارز دیجیتال با هوش مصنوعی، به زبان خودتان
لازم نیست اسم ابزار یا دستوری را بلد باشید. به فارسی بنویسید چه میخواهید، از دیدن موجودی تا خرید و فروش با هوش مصنوعی؛ دستیار خودش می‌فهمد سراغ کدام ابزار سواپولت برود.
«۱۰۰ تتر من را به تومان تبدیل کن»
request_swap
درخواست سواپ
۱۰۰ تتر←تومان۲۵٬۵۴۸٬۳۰۰
منتظر تأیید شما در تلگرام
درخواست را برای تأیید به تلگرامتان فرستادم. تا ۱۵ دقیقه وقت دارید تأییدش کنید.
«آخرین خبرهای بیتکوین را بررسی کن و بگو بیت‌کوینم را نگه دارم یا نه»
جستجوی وبget_balanceget_profit_and_loss
- خبرها: این هفته خبر بد مهمی درباره‌ی خود بیتکوین نبود؛ بیشتر تیترها درباره‌ی ورود پول به ETFهای بیتکوین است.
- موقعیت شما: ۰٫۰۰۲۱ بیتکوین با ۹٫۱٪ سود نسبت به میانگین خرید.
- جمع‌بندی: اگر بلندمدت نگهش می‌دارید، دلیلی برای فروش فوری نمی‌بینم. تصمیم با خودتان است.
خبرها را خود دستیار در وب جستجو میکند؛ موجودی و سود و زیان را از سواپولت می‌گیرد.
چند نمونه‌ی دیگر؛ بزنید تا کپی شود:
مبلغ‌ها نمونه‌اند و با قیمت‌های مهر ۱۴۰۵ حساب شده‌اند.
دستیار نمی‌تواند خودش پول شما را جابهجا کند
ابزارهای سواپ، انتقال و برداشت فقط درخواست ثبت میکنند. تا خودتان در تلگرام دکمهی تأیید را نزنید، هیچ اتفاقی نمی‌افتد؛ و دستیار به تلگرام شما دسترسی ندارد.
🤖 Claude درخواست انجام این عملیات روی حساب شما را دارد:
🔄 جزئیات تبدیل دارایی
• مبدأ: 100 تتر
• مقصد: 25,548,300 تومان
✅ تاییدلغو
✅ تبدیل با موفقیت انجام شد
۱۰:۴۲درخواست
دستیار یکی از ابزارهای درخواست را صدا می‌زند، مثلاً
request_swap، و سواپولت مبلغ و نرخ و کارمزدش را حساب میکند.پیش‌نمایش در تلگرام
ربات سواپولت همین پیام را با دکمه‌های تأیید و لغو برایتان می‌فرستد؛ توی تلگرام، جایی که دست دستیار به آن نمی‌رسد.
تصمیم شما
۱۵ دقیقه وقت دارید. اگر کاری نکنید، درخواست خودش لغو میشود.
اجرا
وقتی تأیید کنید، نرخ یک بار دیگر حساب و کار انجام میشود. دستیار نتیجه را با
get_action_requestچک میکند و تا آن موقع نمی‌گوید «انجام شد».
- دسترسی «برداشت بدون تایید شما» همیشه خاموش است و به هیچ برنامه‌ای داده نمیشود.
- اگر ورود دومرحلهایتان روشن باشد، برداشت ارز دیجیتال و انتقال را نمیشود از دستیار ثبت کرد؛ فقط از خود اپ سواپولت.
- سواپولت چت شما با دستیار را نمی‌بیند؛ فقط اسم ابزاری که صدا زده شده و ورودیهایش به سرور میرسد.
- هر وقت خواستید، دسترسی دستیار را از اپ سواپولت قطع کنید.
خودتان تعیین میکنید دستیار چه چیزهایی را ببیند
بار اول که دستیار به سواپولت وصل میشود، این صفحه باز میشود: با شماره موبایل و کد پیامکی وارد میشوید و تیک هر دسترسیای را که نمی‌خواهید برمیدارید. همین‌جا تیک‌ها را عوض کنید تا ببینید دستیار به کدام ابزارها دسترسی پیدا میکند.
در صفحهی واقعی همهی تیک‌ها از اول زده شده‌اند؛ این‌جا فقط دسترسی‌های خواندنی روشن است.
MCP چیست؟
MCP (مخفف Model Context Protocol) یک استاندارد باز است که دستیارهای هوش مصنوعی با آن به سرویس‌های دیگر وصل می‌شوند. با سرور MCP سواپولت، دستیارتان با اجازهی خودتان اطلاعات حساب سواپولت را میخواند و برایتان درخواست ثبت میکند.
آدرس سرور MCP سواپولت
https://swapwallet.app/mcpلازم نیست چیزی نصب کنید: سرور روی خود سواپولت است و فقط کافی است این آدرس را به دستیارتان بدهید.
دستیار شماClaude، ChatGPT، Cursor
MCP
سرور MCP سواپولتswapwallet.app/mcp
خواندن
حساب شماموجودی، سود و زیان، تراکنشها
سواپ و برداشت
تلگرام شمااجرا فقط پس از تأیید
اتصال به Claude، ChatGPT و دستیارهای دیگر
فقط یک حساب سواپولت لازم دارید. برای سواپ، انتقال و برداشت، حسابتان باید به تلگرام هم وصل باشد.
اتصال Claude به صرافی سواپولت
Claude در وب و اپ دسکتاپ
- در Claude به Settings › Connectors بروید. باز کردن Connectors
- Add custom connector را بزنید، اسمش را SwapWallet بگذارید و این آدرس را وارد کنید:
https://swapwallet.app/mcp - Connect را بزنید. صفحهی ورود سواپولت باز میشود: با شماره موبایل و کد پیامکی وارد شوید و دسترسیها را تأیید کنید.
- حالا توی چت بپرسید: «موجودی سواپ‌ولتم چقدر است؟»
اتصال ChatGPT به صرافی سواپولت
ChatGPT در وب، برای حساب‌هایی که کانکتور سفارشی دارند
- در ChatGPT به Settings › Apps & Connectors بروید و از Advanced settings گزینه‌ی Developer mode را روشن کنید.
- Create را بزنید. اسمش را SwapWallet بگذارید، این آدرس را در MCP Server URL وارد کنید و Authentication را روی OAuth بگذارید:
https://swapwallet.app/mcp - در صفحهی سواپولت وارد شوید و دسترسیها را تأیید کنید.
- یک چت تازه باز کنید، SwapWallet را از لیست ابزارها انتخاب کنید و سؤالتان را بپرسید.
ChatGPT گاهی جای این منوها را عوض میکند. اگر Developer mode را پیدا نکردید، در تنظیمات دنبالش بگردید.
اتصال Cursor به سواپولت
با یک کلیک، یا با فایل کانفیگ
افزودن به Cursorیا این را به ~/.cursor/mcp.json اضافه کنید:
{
"mcpServers": {
"swapwallet": {
"url": "https://swapwallet.app/mcp"
}
}
}بار اول، Cursor صفحهی ورود سواپولت را باز میکند تا وارد شوید.
اتصال Claude Code به سواپولت
در ترمینال، با یک دستور
- این دستور را اجرا کنید:
claude mcp add --transport http swapwallet https://swapwallet.app/mcp - در Claude Code دستور
/mcpرا بزنید، swapwallet را انتخاب کنید و Authenticate را بزنید تا صفحهی ورود سواپولت در مرورگر باز شود.
یا آن را به‌صورت پلاگین نصب کنید. پلاگین اسکیل سواپولت را هم با خودش می‌آورد؛ اسکیلی که به Claude می‌گوید تا شما تأیید نکرده‌اید، هیچ کاری را «انجام شد» گزارش نکند:
/plugin marketplace add SwapWallet/swapwallet-mcp
/plugin install swapwallet@swapwalletکلاینت‌های دیگر
هر کلاینتی که سرور MCP ریموت (HTTP) و ورود با OAuth را پشتیبانی کند
- VS Code (GitHub Copilot)
- نصب در VS Code
code --add-mcp '{"name":"swapwallet","type":"http","url":"https://swapwallet.app/mcp"}' - Gemini CLI
gemini mcp add --transport http swapwallet https://swapwallet.app/mcp- Codex CLI
codex mcp add swapwallet --url https://swapwallet.app/mcp- Windsurf
در ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "swapwallet": { "serverUrl": "https://swapwallet.app/mcp" } } }- بقیه
آدرس را به‌عنوان یک سرور Streamable HTTP اضافه کنید؛ کلاینت خودش می‌فهمد که ورود با OAuth است. راهنمای Cline و بقیه‌ی کلاینت‌ها در llms-install.md است.
یا نصبش را به خود دستیار بسپارید
Claude Code، Codex، Cline و هر ایجنتی که میتواند دستور اجرا کند، با این پیام خودش سرور را اضافه میکند:
سرور MCP سواپولت را برایم نصب کن. راهنمای نصب:
https://github.com/SwapWallet/swapwallet-mcp/blob/main/llms-install.mdبرای توسعه‌دهندگان
سرور روی بک‌اند خود سواپولت اجرا میشود. معرفی سرور، پلاگین‌ها، اسکیل ایجنت و کانفیگ آماده‌ی کلاینت‌ها در گیت‌هاب است.
SwapWallet / swapwallet-mcpMIT
Official SwapWallet MCP server: AI agents read crypto balances, P&L and history, and request swaps, transfers and withdrawals the user approves in Telegram.
server.jsonبرای ثبت در MCP Registry رسمی.mcp.jsonکانفیگ آماده برای Claude Code و کلاینت‌های دیگرskills/swapwallet/SKILL.mdاسکیلی که به ایجنت یاد می‌دهد ابزارها را امن به کار ببرد.claude-plugin/پلاگین Claude Code، همراه همین اسکیل.codex-plugin/پلاگین Codexgemini-extension.jsonاکستنشن Gemini CLIllms-install.mdراهنمای نصب برای ایجنت‌هایی که خودشان نصب میکنند
- آدرس
https://swapwallet.app/mcp- نوع اتصال
- Streamable HTTP، پاسخ JSON، stateless
- احراز هویت
- OAuth 2.1 با ثبت خودکار کلاینت (RFC 7591) و PKCE؛ بدونAPI Key
- اعتبار توکن
- access token یک ساعت؛ refresh token تا وقتی دسترسی را قطع کنید
- نسخه‌ی پروتکل
2025-06-18, 2025-03-26, 2024-11-05- رجیستری رسمی
- app.swapwallet/mcp
| ابزار | کارش | دسترسی لازم |
|---|---|---|
get_total_balance | ارزش کل دارایی | مشاهده موجودی |
get_balance | موجودی هر ارز | مشاهده موجودی |
get_user_info | اطلاعات حساب | مشاهده موجودی |
get_deposit_address | آدرس واریز | مشاهده موجودی |
get_profit_and_loss | سود و زیان | مشاهده پرتفوی |
get_transactions | تاریخچه‌ی تراکنشها | مشاهده تراکنشها |
get_contacts | مخاطب‌ها | مشاهده مخاطبین |
get_ibans | شباهای تأییدشده | مشاهده مخاطبین |
get_action_request | وضعیت درخواست | همه |
request_swap | سواپبا تأیید شما | درخواست تایید تبدیل |
request_transfer | انتقال به مخاطببا تأیید شما | درخواست تایید انتقال |
request_crypto_withdraw | برداشت ارز دیجیتالبا تأیید شما | درخواست تایید برداشت |
request_fiat_withdraw | برداشت تومانیبا تأیید شما | درخواست تایید برداشت |
- مستندات فنی کاملابزارها، ورودی‌ها، وضعیت‌ها و جریان OAuth، به انگلیسی
- server-card.jsonکارت سرور MCP با لیست کامل ابزارها
- ard.jsonمانیفست Agentic Resource Discovery، تا ایجنت‌ها سرور را خودشان پیدا کنند
- Glamaصفحهی سرور در Glama
- مستندات APIREST API سواپولت برای ساخت سرویس خودتان
پرسش‌های پرتکرار
MCP چیست و سرور MCP چه کاری میکند؟
MCP (مخفف Model Context Protocol) یک استاندارد باز است که دستیارهای هوش مصنوعی مثل Claude و ChatGPT با آن به سرویس‌های دیگر وصل می‌شوند. سرور MCP هر سرویس، کارهایی را که دستیار میتواند آن‌جا انجام دهد به شکل «ابزار» در اختیارش می‌گذارد. سرور MCP سواپولت همین کار را برای حساب سواپولت شما میکند: دستیار با اجازهی خودتان موجودی، سود و زیان و تراکنشها را میخواند و برای سواپ، انتقال یا برداشت درخواست ثبت میکند.
چطور Claude را به صرافی ارز دیجیتال سواپولت وصل کنم؟
در Claude به Settings و بخش Connectors بروید، Add custom connector را بزنید و آدرس https://swapwallet.app/mcp را وارد کنید. Connect را که بزنید، صفحهی ورود سواپولت باز میشود؛ با شماره موبایل و کد پیامکی وارد شوید و دسترسیها را تأیید کنید. در Claude Code همین کار با یک دستور انجام میشود.
آیا ChatGPT هم به صرافی سواپولت وصل میشود؟
بله. در ChatGPT از بخش Apps & Connectors، Developer mode را روشن کنید، با Create یک کانکتور تازه بسازید، آدرس https://swapwallet.app/mcp را وارد کنید و Authentication را روی OAuth بگذارید. این گزینه فقط در حساب‌هایی از ChatGPT هست که کانکتور سفارشی دارند.
آیا با هوش مصنوعی میتوانم ارز دیجیتال بخرم و بفروشم؟
بله. کافی است بنویسید چه میخواهید، مثلاً «با ۱۰۰ تتر بیتکوین بخر». دستیار درخواست سواپ را ثبت میکند و پیامش با نرخ و مقدار دقیق به تلگرامتان میآید. خرید یا فروش فقط وقتی انجام میشود که خودتان در تلگرام تأیید کنید، و کارمزدش همان کارمزد همیشگی سواپ در سواپولت است.
آیا دستیار هوش مصنوعی میتواند بدون اجازهی من پول جابهجا کند؟
نه. ابزارهای سواپ، انتقال و برداشت فقط درخواست ثبت میکنند. هر درخواست با همهی جزئیاتش به تلگرامتان میآید و فقط وقتی انجام میشود که دکمهی تأیید را بزنید؛ اگر تا ۱۵ دقیقه جواب ندهید، خودش لغو میشود. دسترسیای برای انجام مستقیم وجود ندارد و به هیچ دستیاری هم داده نمیشود.
برای اتصال API Key لازم دارم؟
نه. ورود با OAuth است: در صفحهی سواپولت با شماره موبایل و کد پیامکی وارد میشوید و دسترسیها را تأیید میکنید. چیزی هم لازم نیست نصب کنید، چون سرور روی خود سواپولت است. API Keyهای سواپولت برای این سرور کار نمیکنند.
سواپولت چت من با دستیار را میبیند؟
نه. به سرور سواپولت فقط اسم ابزاری که دستیار صدا زده و ورودیهایش میرسد، نه متن چت. ولی چیزهایی که دستیار از حسابتان میخواند، مثل موجودی، به سرویس همان دستیار میرود؛ پس فقط دسترسیهایی را بدهید که واقعاً لازم دارید.
چطور دسترسی دستیار را محدود یا قطع کنم؟
موقع اتصال، لیست دسترسیها را میبینید و تیک هرکدام را که نخواهید برمیدارید؛ مثلاً فقط دیدن موجودی و تراکنشها را باز بگذارید. دستیار فقط ابزارهای همان دسترسیهایی را میبیند که تأیید کردهاید. هر وقت هم خواستید، دسترسی را از اپ سواپولت قطع کنید.
چرا درخواست برداشت یا سواپ از دستیار ثبت نمیشود؟
برای ثبت هر درخواستی، حساب سواپولتتان باید به تلگرام وصل باشد، چون تأیید همانجا انجام میشود. اگر ورود دومرحلهایتان روشن باشد، برداشت ارز دیجیتال و انتقال به مخاطب را هم نمیشود از دستیار ثبت کرد و باید از خود اپ سواپولت انجامش دهید؛ سواپ و برداشت تومانی این محدودیت را ندارند.
استفاده از سرور MCP سواپولت هزینه دارد؟
نه، اتصال و خواندن اطلاعات رایگان است. سواپ یا برداشتی که تأیید کنید، همان کارمزد همیشگی سواپولت را دارد.
دستیارتان را به سواپولت وصل کنید
حساب ندارید؟ ساختنش چند دقیقه بیشتر طول نمی‌کشد. بعد آدرس سرور را به دستیارتان بدهید و اولین سؤالتان را بپرسید.
سؤال دیگری دارید؟ مرکز راهنما یا تماس با پشتیبانی