برای دستیارهای هوش مصنوعی

سواپ‌ولت در دستیار هوش مصنوعی شما

Claude، Cursor یا هر دستیار سازگار با MCP را به حساب سواپ‌ولت‌تان وصل کنید تا موجودی، تراکنش‌ها و سود و زیان را بخواند و درخواست سواپ، انتقال یا برداشت ثبت کند. هیچ تراکنشی بدون تأیید خودتان در تلگرام انجام نمی‌شود.

نشانی سرور MCP
https://swapwallet.app/mcp
  • ۱۳ابزار
  • ۷مجوز قابل انتخاب
  • ۰تراکنش بدون تأیید شما
swapwallet.app/.well-known/ard.json
{
  "identifier": "urn:air:swapwallet.app:mcp:swapwallet",
  "displayName": "SwapWallet MCP server",
  "type": "application/mcp-server-card+json",
  "url": "https://swapwallet.app/.well-known/mcp/server-card.json",
  "capabilities": [
    "get_total_balance",
    "get_balance",
    "get_user_info",
    "…"
  ],
  "representativeQueries": [
    "what is my crypto balance on SwapWallet",
    "swap 100 USDT to toman in my SwapWallet account"
  ]
}

اتصال در یک دقیقه

  1. Claude در وب و دسکتاپ

    در تنظیمات، بخش Connectors گزینه‌ی Add custom connector را بزنید و این نشانی را وارد کنید:

    https://swapwallet.app/mcp
  2. Claude Code

    این فرمان را در ترمینال اجرا کنید. بار اول که ابزاری صدا زده شود، صفحه‌ی ورود باز می‌شود.

    claude mcp add --transport http swapwallet https://swapwallet.app/mcp
  3. Cursor و کلاینت‌های دیگر

    این بخش را به فایل تنظیمات MCP کلاینت اضافه کنید:

    {
      "mcpServers": {
        "swapwallet": {
          "url": "https://swapwallet.app/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

هیچ پولی بدون تأیید شما جابه‌جا نمی‌شود

  1. درخواست

    دستیار یکی از ابزارهای درخواست را صدا می‌زند و سواپ‌ولت مبلغ، نرخ و کارمزد را محاسبه می‌کند.

  2. پیش‌نمایش در تلگرام

    جزئیات کامل درخواست با دکمه‌های تأیید و لغو در ربات سواپ‌ولت برایتان فرستاده می‌شود.

  3. تصمیم شما

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

  4. اجرا

    پس از تأیید، نرخ دوباره محاسبه و درخواست اجرا می‌شود. دستیار نتیجه را از وضعیت درخواست می‌خواند.

  • هیچ مجوزی به دستیار اجازه نمی‌دهد بدون تأیید شما پولی جابه‌جا کند.
  • دستیار فقط ابزارهایی را می‌بیند که مجوزشان را داده‌اید و این مجوزها در هر درخواست دوباره بررسی می‌شوند.
  • اگر ورود دومرحله‌ای فعال باشد، برداشت ارز دیجیتال و انتقال فقط از اپلیکیشن سواپ‌ولت ممکن است.
  • برای ثبت درخواست، حساب سواپ‌ولت باید به تلگرام متصل باشد.

Agentic Resource Discovery

کشف خودکار برای عامل‌های هوش مصنوعی

سواپ‌ولت منابعش را طبق استاندارد باز ARD منتشر می‌کند تا عامل‌ها و هماهنگ‌کننده‌های هوش مصنوعی، بدون تنظیم از پیش و با یک جستجوی ساده، سرور MCP سواپ‌ولت را پیدا کنند. پرسش را به فارسی یا انگلیسی بنویسید؛ همان درخواستی که یک عامل به رجیستری می‌فرستد از همین‌جا ارسال می‌شود.

POST swapwallet.app/ard/search
۱ نتیجهHTTP 200
  1. سرور MCP

    SwapWallet MCP server

    ۹۴
    urn:air:swapwallet.app:mcp:swapwallet

    Remote MCP server for a user's own account on SwapWallet, a custodial Iranian crypto exchange. Read balances, deposit addresses, profit and loss and transaction history; request swaps, transfers and crypto or toman withdrawals. No tool moves money by itself: every money-moving request is priced and sent to the user's Telegram, and runs only after the user approves it there. OAuth 2.1 sign-in, no API keys.

    • get_total_balance
    • get_balance
    • get_user_info
    • get_deposit_address
    • get_profit_and_loss
    • get_transactions
    • +7
    swapwallet.app/.well-known/mcp/server-card.json

امتیاز فقط میزان ارتباط هر منبع با پرسش است، نه سنجه‌ی اعتماد یا امنیت.

سوالات پرتکرار

آیا دستیار هوش مصنوعی می‌تواند بدون اجازه‌ی من پول جابه‌جا کند؟

خیر. ابزارهای سواپ، انتقال و برداشت فقط درخواست ثبت می‌کنند. هر درخواست با جزئیات کامل به تلگرام شما فرستاده می‌شود و تنها پس از زدن دکمه‌ی تأیید اجرا می‌شود. مجوزی برای اجرای مستقیم وجود ندارد و به هیچ دستیاری داده نمی‌شود.

کدام دستیارها از سرور MCP سواپ‌ولت پشتیبانی می‌کنند؟

هر کلاینتی که سرور MCP راه دور (HTTP) با ورود OAuth را پشتیبانی کند؛ از جمله Claude در وب و دسکتاپ، Claude Code و Cursor.

برای اتصال به کلید API نیاز دارم؟

خیر. ورود با OAuth انجام می‌شود: در صفحه‌ی سواپ‌ولت با شماره‌ی موبایل و کد پیامکی وارد می‌شوید و مجوزها را تأیید می‌کنید. کلیدهای API سواپ‌ولت برای این سرور پذیرفته نمی‌شوند.

چطور دسترسی دستیار را محدود کنم؟

هنگام اتصال، فهرست مجوزها نمایش داده می‌شود و می‌توانید هرکدام را بردارید؛ مثلاً فقط خواندن موجودی و تراکنش‌ها را مجاز کنید. دستیار فقط ابزارهای مربوط به مجوزهای تأییدشده را می‌بیند.

چرا درخواست برداشت ارز از طریق دستیار پذیرفته نمی‌شود؟

اگر ورود دومرحله‌ای حسابتان فعال باشد، برداشت ارز دیجیتال و انتقال به مخاطب از طریق دستیار ثبت نمی‌شود و باید آن را در اپلیکیشن سواپ‌ولت انجام دهید. سواپ و برداشت تومانی این محدودیت را ندارند.

ARD چیست و چه فایده‌ای دارد؟

Agentic Resource Discovery استانداردی باز برای معرفی و جستجوی ابزارها و عامل‌های هوش مصنوعی است. سواپ‌ولت منابعش را در /.well-known/ard.json منتشر کرده و رجیستری جستجوی خودش را در /ard دارد تا عامل‌ها بدون تنظیم از پیش، سرور MCP سواپ‌ولت را پیدا کنند.

سواپ‌ولت را به دستیارتان وصل کنید

برای استفاده از سرور MCP به حساب سواپ‌ولت متصل به تلگرام نیاز دارید. پس از ورود، نشانی سرور را در دستیارتان اضافه کنید.

ورود به سواپ‌ولت