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 提供给付款人 → 等待 paid，直到 get_invoice。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`	列出兑换记录

Webhook

工具	功能
`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