SwapWallet

SwapWallet MCP 服务

SwapWallet 的官方远程 MCP 服务：SwapWallet。
让你的 AI 助手读取加密货币余额、盈亏和历史记录，并发起兑换、转账和提现请求；只有在你于 Telegram 中批准后才会执行。

https://swapwallet.app/mcp

由 SwapWallet 托管：无需安装或运行任何内容。将 URL 添加到支持远程服务的 MCP 客户端，使用 OAuth 登录一次，然后选择允许助手执行的操作。

目录

• 你可以询问的内容
• 未经你批准，任何操作都不会执行
• 工具
• 连接
• 身份验证和权限范围
• 面向 Agent 开发者
• 关于此代码库

你可以询问的内容

• “我的 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 机器人）向你发送预览，其中包含 Approve 和 Cancel 按钮。
3. 只有在你点击 Approve 后，操作才会重新定价并执行。未响应的请求会在 15 分钟后过期。
4. 助手通过 get_action_request 查询操作结果。

不存在允许 Agent 在未经你同意的情况下转移资金的权限范围：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

使用 OAuth 2.1 搭配动态客户端注册（RFC 7591）和 PKCE（S256）；面向公众的客户端，无需密钥，也无需 API 密钥。你可以在 SwapWallet 的授权页面使用手机号码和短信验证码登录，查看权限范围，取消勾选不需要的权限，然后批准。你可以随时在应用中撤销访问权限。

tools/list 只会返回你获准的权限范围所允许的工具，并且每次调用时都会再次检查权限范围。访问令牌有效期为 1 小时；刷新令牌会一直有效，直到你撤销授权。

**要求：**拥有 SwapWallet 账户（使用手机号码在 swapwallet.app 注册；交易和提现需要完成身份验证），并关联 Telegram 账户才能使用 request_* 工具。

面向 Agent 开发者

• 端点 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 运营。提供 Web 应用、Android 应用和 Telegram 小程序。

• 支持：[email protected] · 在线客服
• 隐私政策 · 服务条款 · 费用

安全

如需报告 MCP 服务或 OAuth 流程中的漏洞，请按照安全政策（security.txt）中的说明私下报告，不要在公开 issue 中报告。

许可证

此存储库的内容依据 MIT 许可证 发布。