SwapWallet

SwapWallet MCP サーバー

SwapWalletの公式リモート MCP サーバーです。
AI アシスタントが暗号資産の残高、損益、取引履歴を読み取り、Telegramでお客様が承認した後にのみ実行されるスワップ、送金、出金をリクエストできます。

https://swapwallet.app/mcp

SwapWalletがホストしているため、インストールや実行は不要です。リモートサーバーに対応した任意のMCPクライアントにURLを追加し、OAuthで一度サインインしてから、アシスタントに許可する操作を選んでください。

目次

• 質問できること
• 承認なしに資金が動くことはありません
• ツール
• 接続
• 認証とスコープ
• エージェント開発者向け
• このリポジトリについて

質問できること

• 「SwapWalletの残高合計はいくらですか？そのうちUSDTはいくらですか？」
• 「BTCとTONの損益を表示して。」
• 「今週の直近10件の取引を一覧表示して。」
• 「TRONでUSDTを入金するためのアドレスを教えて。」
• 「50 USDTをTONにスワップして。」 （Telegramで承認するリクエストが作成されます）
• 「認証済みの銀行口座に2,000,000 tomanを出金して。」 （Telegramで承認するリクエストが作成されます）

承認なしに資金が動くことはありません

読み取りツールは直接回答します。資金を動かすツールが独自に処理を実行することはありません。

1. アシスタントがrequest_swap、request_transfer、request_crypto_withdraw、またはrequest_fiat_withdrawを呼び出します。
2. SwapWalletが操作の価格を算出し、TelegramのSwapWalletボットから、承認とキャンセルのボタン付きプレビューを送信します。
3. 承認をタップした場合に限り、操作の価格が再算出され、実行されます。応答のないリクエストは15分後に期限切れになります。
4. アシスタントがget_action_requestで結果を確認します。

エージェントがお客様の承認なしに資金を動かせるスコープはありません。withdraw:executeは存在しますが、付与することはできません。二要素認証が有効な場合、暗号資産の出金と送金はMCP経由でリクエストできません。アプリから操作してください。

ツール

すべてのツールにはMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）が設定されています。破壊的なツールはありません。request_*ツールは、承認またはキャンセルできるリクエストを追加するだけです。入力スキーマを含む完全な定義は、サーバーカード（/.well-known/mcp/server-card.json）にあります。

接続

claude mcp add --transport http swapwallet https://swapwallet.app/mcp

/plugin marketplace add SwapWallet/swapwallet-mcp
/plugin install swapwallet@swapwallet

{
  "mcpServers": {
    "swapwallet": { "url": "https://swapwallet.app/mcp" }
  }
}

code --add-mcp '{"name":"swapwallet","type":"http","url":"https://swapwallet.app/mcp"}'

{
  "mcpServers": {
    "swapwallet": { "serverUrl": "https://swapwallet.app/mcp" }
  }
}

gemini mcp add --transport http swapwallet https://swapwallet.app/mcp

gemini extensions install https://github.com/SwapWallet/swapwallet-mcp

codex mcp add swapwallet --url https://swapwallet.app/mcp

動的クライアント登録（RFC 7591）と PKCE（S256）を使用する OAuth 2.1 です。パブリッククライアントのため、シークレットや API キーは不要です。SwapWallet の同意ページで電話番号と SMS コードを使ってサインインし、スコープを確認して、不要なもののチェックを外してから承認します。アクセス権はいつでもアプリから取り消せます。

tools/list で返されるのは、許可されたスコープで利用できるツールのみです。また、スコープは呼び出しのたびに再確認されます。アクセストークンの有効期間は 1 時間です。リフレッシュトークンは許可を取り消すまで有効です。

要件： SwapWallet アカウント（電話番号を使って swapwallet.app で登録してください。取引と出金には本人確認が必要です）、および request_* ツールを使うための Telegram アカウントの連携。

エージェント開発者向け

• エンドポイントは https://swapwallet.app/mcp です。Streamable HTTP、JSON 応答のみ、ステートレス（セッション、SSE、バッチなし）です。プロトコルバージョンは 2025-06-18、2025-03-26、2024-11-05 です。
• 検出先：/.well-known/oauth-protected-resource、/.well-known/oauth-authorization-server、およびサーバーカード。
• 金額は小数を含む文字列です。token と network は、各ツールの入力スキーマに記載された列挙値です。
• get_action_request が EXECUTED を返すまでは、スワップ、送金、出金が完了したと報告しないでください。PENDING は「Telegram でユーザーの対応待ち」を意味します。ルールの全容は skills/swapwallet/SKILL.md をご覧ください。

完全なリファレンス：swapwallet.app/docs/mcp · REST API：docs.swapwallet.app

このリポジトリについて

サーバーは SwapWallet のバックエンド内で動作します。このリポジトリには公開用の説明とクライアント設定が含まれているため、リポジトリに対応したツールからインストールできます。

ドキュメントやクライアント設定に問題が見つかった場合は、issue または pull request を作成してください。

SwapWallet について

SwapWallet（سواپ‌ولت）は、ウォレット形式のアプリを提供するイランの暗号資産取引所です。暗号資産の購入、売却、スワップ、保有、送金に加えて、トマンの入金と出金ができます。カストディアル型で、Zanjireh Tabdil Soba が運営しています。ウェブアプリ、Android アプリ、Telegram ミニアプリを提供しています。

• サポート：[email protected] · ライブチャット
• プライバシーポリシー · 利用規約 · 手数料

セキュリティ

MCP サーバーまたは OAuth フローの脆弱性は、公開 issue ではなく、セキュリティポリシー（security.txt）に記載された方法に従って、非公開で報告してください。

ライセンス

このリポジトリの内容は、MIT ライセンスのもとで公開されています。