SnapEX Pay

官方

為 AI 代理提供加密貨幣支付：自助式帳戶、發票、收款、付款及兌換。

你可以用 SnapEX Pay MCP 做什麼？

開立商戶帳戶 — 讓代理程式呼叫 create_account，即可取得 api_key、後台 login/password 和 mcp_personal_url，無需驗證碼或電子郵件。
建立並追蹤發票 — 使用 create_invoice 取得付款人的 pay_url，接著輪詢 get_invoice，直到狀態為 paid；測試模式不涉及真實資金。
安全地發送加密貨幣款項 — 使用 preview_payout 取得報價，再透過 create_payout 搭配 preview_id 和 idempotency_key 建立付款，確保重試不會重複付款。
查看目錄和手續費 — 在需要任何金鑰之前，先查詢 list_assets、get_fiat_rates、get_fees 和 list_static_address_networks。
兌換持有的資產 — 使用 preview_conversion 取得報價，再透過 create_conversion 執行兌換，將其他資產換成 USDT 餘額。

託管 MCP 伺服器

npx add-mcp 'https://pay.snapex.pro/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

SnapEX Pay MCP 伺服器

用於加密貨幣付款的 MCP 伺服器：AI 代理會自行開設商家帳戶，並接受、發送及兌換加密貨幣。

SnapEX Pay MCP 伺服器讓 AI 代理無需人工介入即可處理加密貨幣付款。代理連線至 https://pay.snapex.pro/mcp,，自行開設 SnapEX Pay 商家帳戶（無需驗證碼或電子郵件），並取得 API 金鑰。接著，它可以建立含有託管付款頁面的發票、透過永久存款地址收取加密貨幣、持有 USDT 餘額、以多種幣種和網路發送付款，並管理 webhook。測試模式可在不使用真實資金的情況下執行完整流程。付款一律先進行免費預覽，並使用冪等金鑰，因此重試不會重複付款。可使用遠端伺服器（Streamable HTTP）或本機套件：npx -y snapex-pay-mcp。

遠端伺服器（建議使用，無需安裝）： https://pay.snapex.pro/mcp — Streamable HTTP。
本機 stdio 套件： npx -y snapex-pay-mcp — 提供相同工具，是同一 API 的輕量用戶端。
Docker： docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp。
MCP Registry 名稱：pro.snapex/pay。
人類閱讀的文件：https://pay.snapex.pro/mcp · REST 參考：https://pay.snapex.pro/partner/merchant/docs · 伺服器卡片：https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
隱私權政策：https://pay.snapex.pro/privacy · 條款：https://pay.snapex.pro/terms · 商家規則： https://pay.snapex.pro/rules · 支援：https://pay.snapex.pro/#chat

代理的使用方式

不使用金鑰即可連線。目錄工具（list_assets、get_fiat_rates、get_fees、list_static_address_networks）可立即使用。
呼叫 create_account。它會回傳 api_key（僅顯示一次）、供人使用的管理介面 login/password，以及 mcp_personal_url。新金鑰會立即生效：遠端伺服器會在本次 MCP 工作階段的其餘時間使用該金鑰；stdio 套件會在該程序中使用該金鑰（並將其儲存至 ~/.config/snapex-pay/credentials.json，供下次執行時使用）。
收款：create_invoice → 將 pay_url 提供給付款人 → get_invoice，直到 paid。environment: "test" 可在不使用真實資金的情況下執行完整流程（選擇幣種後約 10 秒，測試發票會變成已付款；餘額不會變動）。
付款：preview_payout（免費報價）→ 使用 preview_id 和你自己的 idempotency_key 呼叫 create_payout（不可撤銷；使用相同金鑰重試不會重複付款）。
餘額以 USDT 持有：若要取得其他幣種，請以該幣種付款。preview_conversion → create_conversion 可兌換舊帳戶仍持有的其他資產。

每個錯誤回覆都會說明下一步該怎麼做（what_to_do），例如 unauthorized → 呼叫 create_account；rate_limited → 等待 retry_after_seconds。

連線

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
# with an existing key:
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp --header "Authorization: Bearer smk_…"

Cursor — `~/.cursor/mcp.json`

{
  "mcpServers": {
    "snapex-pay": { "url": "https://pay.snapex.pro/mcp" }
  }
}

新增 "headers": { "Authorization": "Bearer smk_…" }，即可在不同工作階段使用同一個帳戶。

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "snapex-pay": { "type": "http", "url": "https://pay.snapex.pro/mcp" }
  }
}

Windsurf — `~/.codeium/windsurf/mcp_config.json`

{
  "mcpServers": {
    "snapex-pay": { "serverUrl": "https://pay.snapex.pro/mcp" }
  }
}

Cline — `cline_mcp_settings.json`

{
  "mcpServers": {
    "snapex-pay": { "type": "streamableHttp", "url": "https://pay.snapex.pro/mcp" }
  }
}

AI 安裝程式的逐步指南：llms-install.md。

Gemini CLI

以擴充功能方式使用（此儲存庫包含 gemini-extension.json）：

gemini extensions install https://github.com/snapexpay/snapex-pay-mcp

或在 ~/.gemini/settings.json 中使用：

{
  "mcpServers": {
    "snapex-pay": { "httpUrl": "https://pay.snapex.pro/mcp" }
  }
}

Claude Desktop — `claude_desktop_config.json`

透過 mcp-remote 使用遠端伺服器：

{
  "mcpServers": {
    "snapex-pay": { "command": "npx", "args": ["-y", "mcp-remote", "https://pay.snapex.pro/mcp"] }
  }
}

或使用本機套件：

{
  "mcpServers": {
    "snapex-pay": {
      "command": "npx",
      "args": ["-y", "snapex-pay-mcp"],
      "env": { "SNAPEX_API_KEY": "smk_…" }
    }
  }
}

（SNAPEX_API_KEY 為選用項目：若未設定，代理會呼叫 create_account，並儲存金鑰供下次執行時使用。）

claude.ai 和 ChatGPT 連接器

使用 URL https://pay.snapex.pro/mcp 新增自訂連接器，且不設定驗證。這些用戶端無法傳送標頭，因此在 create_account 之後，請從其回覆中取得 mcp_personal_url（也會由 get_account 回傳），並將其用作連接器 URL — 之後每個新對話都會使用同一個帳戶。該 URL 含有憑證，請將其視同密碼保管。

OpenAI Responses API

{
  "type": "mcp",
  "server_label": "snapex_pay",
  "server_url": "https://pay.snapex.pro/mcp",
  "headers": { "Authorization": "Bearer smk_…" },
  "require_approval": { "always": { "tool_names": ["create_payout", "create_conversion"] } }
}

其他用戶端和目錄

此儲存庫包含目錄會讀取的資訊清單：server.json（官方 MCP Registry）、glama.json（Glama）、 gemini-extension.json + GEMINI.md（Gemini CLI）、lhm.plugin.json（LobeHub）、.cursor-plugin/plugin.json + mcp.json（Cursor Marketplace）、plugin.json（Agent Plugins / Kiro）、llms-install.md（Cline）。

Docker

docker build -t snapex-pay-mcp .
docker run -i --rm -e SNAPEX_API_KEY=smk_… snapex-pay-mcp

工具

帳戶

工具	功能
`create_account`	開設 SnapEX Pay 帳戶（無需驗證碼）
`get_account`	顯示目前帳戶和金鑰

目錄（無需金鑰）

工具	功能
`list_assets`	列出幣種和網路
`get_fiat_rates`	法幣匯率
`get_fees`	目前路由費用報價
`list_static_address_networks`	永久地址可用的網路

餘額

工具	功能
`get_balances`	帳戶餘額
`list_transactions`	餘額記錄

收款

工具	功能
`create_invoice`	建立發票（收取加密貨幣）
`get_invoice`	發票狀態
`list_invoices`	列出發票
`get_invoice_payment_methods`	可用於支付發票的幣種
`select_invoice_payment_method`	為發票選擇幣種
`preview_payment`	直接付款報價
`create_payment`	建立直接付款
`get_payment`	付款狀態
`list_payments`	列出付款
`create_static_address`	永久存款地址
`list_static_addresses`	列出永久地址
`list_static_address_deposits`	永久地址的存款

付款（出款）

工具	功能
`preview_payout`	付款報價（發送加密貨幣）
`create_payout`	發送付款（不可撤銷）⚠️ 不可撤銷
`get_payout`	付款狀態
`list_payouts`	列出付款

兌換

工具	功能
`preview_conversion`	兌換報價
`create_conversion`	執行兌換 ⚠️ 不可撤銷
`get_conversion`	兌換狀態
`list_conversions`	列出兌換

Webhooks

工具	功能
`list_webhooks`	列出 webhook 端點
`create_webhook`	新增 webhook 端點
`update_webhook`	變更 webhook 端點
`rotate_webhook_secret`	新增 webhook 密鑰 ⚠️ 不可撤銷

資源：snapex://docs/quickstart、snapex://docs/webhooks。提示：accept_crypto_payment、send_crypto_payout。

環境變數（stdio 套件）

變數	預設值	說明
`SNAPEX_API_KEY`	—	商家 API 金鑰 `smk_…`。選用：`create_account` 會建立一組金鑰。
`SNAPEX_BASE_URL`	`https://pay.snapex.pro`	API 基底 URL。
`SNAPEX_CREDENTIALS_FILE`	`~/.config/snapex-pay/credentials.json`	儲存來自 `create_account` 的金鑰的位置（權限模式 600）。
`SNAPEX_NO_SAVE`	—	`1` — 不將憑證儲存至磁碟。

安全性

代理只能動用自己帳戶中的資金；新帳戶的初始餘額為零。
金鑰和產生的密碼只會顯示一次。使用者可透過登入名稱和密碼開啟管理介面，並在其中撤銷或輪替金鑰。
付款分為兩個步驟（報價，然後發送），且需要 idempotency_key；create_payout、create_conversion 和 rotate_webhook_secret 標記為 destructiveHint，因此用戶端可在執行前先詢問。
限制：每個 IP 每小時可建立少量新帳戶；每個金鑰每分鐘約 120 次 API 呼叫；每分鐘最多 5 筆付款，每小時最多 30 筆。
可銷售商品的規則：https://pay.snapex.pro/rules。

開發

工具清單是從 SnapEX Pay 伺服器產生的（app/Mcp/McpToolCatalog.php）：

php artisan mcp:export-tools      # writes src/tools.json, syncs the version of the manifests and LobeHub's tools
npm ci && npm test                # build + offline smoke test with the official MCP SDK client
SNAPEX_E2E_BASE_URL=http://127.0.0.1:8765 node test/smoke.mjs   # full flow against a local (never production) server

支援

聊天：https://pay.snapex.pro/#chat · 隱私權：https://pay.snapex.pro/privacy · 條款：https://pay.snapex.pro/terms

授權條款

MIT