SnapEX Pay

SnapEX Pay MCP サーバー

暗号資産決済用のMCPサーバーです。AIエージェントが独自の加盟店アカウントを開設し、暗号資産の受け取り、送金、交換を行えます。

SnapEX Pay MCPサーバーを使うと、人を介さずにAIエージェントが暗号資産決済を利用できます。エージェントは https://pay.snapex.pro/mcp に接続し、自らSnapEX Pay加盟店アカウントを開設して（CAPTCHAもメールも不要）、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

エージェントでの使い方

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を渡す → paidになるまでget_invoiceを呼び出します。environment: "test"では、実際のお金を使わずに一連のフローを実行できます（コインを選択してから約10秒後にテスト用請求書が支払い済みになり、残高は変わりません）。
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は任意です。指定しない場合、エージェントがcreate_accountを呼び出し、キーは次回の実行に備えて保存されます。）

claude.aiとChatGPTのコネクター

URLにhttps://pay.snapex.pro/mcpを指定し、認証なしでカスタムコネクターを追加します。これらのクライアントはヘッダーを送信できないため、create_accountの後、その応答（get_accountでも返されます）からmcp_personal_urlを取得し、コネクターの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 アカウントを開設します（CAPTCHA 不要）
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 — 認証情報をディスクに保存しません。

安全性

• エージェントが動かせるのは自身のアカウントの資金のみです。新しいアカウントの残高はゼロです。
• キーと生成されたパスワードは一度だけ表示されます。ログイン情報とパスワードを使って管理画面を開き、そこでキーを失効またはローテーションできます。
• 払い出しは 2 段階（見積もり、続いて送金）で行われ、idempotency_key が必要です。create_payout、create_conversion、rotate_webhook_secret は destructiveHint としてマークされているため、クライアントは実行前に確認できます。
• 制限：1 時間あたり、1 つの 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