SnapEX Pay

SnapEX Pay MCP 服务

用于加密货币支付的 MCP 服务：AI Agent 可自行开设商户账户，接收、发送和兑换加密货币。

SnapEX Pay MCP 服务让 AI Agent 无需人工介入即可处理加密货币支付。Agent 连接到 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

Agent 如何使用

1. 无需密钥即可连接。目录工具（list_assets、get_fiat_rates、get_fees、list_static_address_networks）可立即使用。
2. 调用 create_account。它会返回 api_key（仅显示一次）、供用户使用的账户 login/password，以及 mcp_personal_url。新密钥会立即生效：在远程服务上用于当前 MCP 会话的后续操作，在 stdio 软件包中用于当前进程（并保存到 ~/.config/snapex-pay/credentials.json，供下次运行使用）。
3. 接收款项：create_invoice → 将 pay_url 提供给付款方 → 持续调用 get_invoice，直到状态变为 paid。environment: "test" 可在不涉及真实资金的情况下运行 完整流程（选择币种后约 10 s，测试发票会变为已付款；余额不会改变）。
4. 发送款项：preview_payout（免费报价）→ 使用 preview_id 和你自己的 idempotency_key 调用 create_payout（不可撤销；使用相同的密钥重试不会导致重复付款）。
5. 余额以 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 为可选项：不设置时，Agent 会调用 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 — 不将凭据保存到磁盘。

安全

• Agent 只能动用自己账户中的资金；新账户的初始余额为零。
• 密钥和生成的密码仅显示一次。用户可以使用登录名和密码进入账户后台，并在那里撤销或轮换密钥。
• 付款分两步进行（报价，然后发送），并需要 idempotency_key；create_payout、create_conversion 和 rotate_webhook_secret 标记为 destructiveHint，因此客户端可以在运行前询问。
• 限制：每个 IP 每小时可创建几个新账户；每个密钥每分钟约可调用 API 120 次；付款每分钟 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