SpherePay

SpherePay MCP サーバー

SpherePay決済プラットフォーム用のModel Context Protocolサーバーです。Claude から顧客、銀行口座、ウォレット、送金、仮想口座、Webhook、CCTP オフランプを直接管理できます。

機能

• 厳選された24個のツール — 複数ステップの操作に対応する9個のワークフローツールと、即時検索用の15個の読み取り専用ツール
• 自動リトライ — 指数バックオフとレート制限への対応
• 送金の冪等性 — 重複リクエストは安全に重複排除されます
• ログ内の個人情報のマスキング — 口座番号、銀行コード、個人データはログに記録されません
• ツールの実行境界で入力を検証 — API 呼び出しの前に、ID、通貨、ネットワーク、金額を検証します
• デスクトップ拡張機能（.mcpb） — ワンクリックで Claude Desktop にインストールできます

ツール

ワークフローツール

ツール	説明
onboard_customer	顧客（個人または法人）を作成し、TOS/KYC 検証リンクを生成します
verify_customer	2段階認証：OTP を送信し、その後、顔認証で確認します
setup_funding	顧客の銀行口座（USD/EUR）または暗号資産ウォレットを作成します
execute_transfer	冪等性を自動処理して、資金調達手段間で送金します
onboard_business_rep	法人代表者を作成して確認します
setup_virtual_account	法定通貨をステーブルコインに自動変換する仮想口座を作成します
setup_offloader_wallet	ステーブルコインを法定通貨に変換するオフランプ用ウォレットを作成します
create_webhook	HTTPS Webhook 経由でイベント通知を受信するよう登録します
submit_cctp_offramp	クロスチェーンのオフランプ償還用に CCTP バーン取引を送信します

読み取り専用ツール

ツール	説明
get_customer / list_customers	顧客の詳細と確認状況を取得します
get_transfer / list_transfers	送金情報を取得し、顧客／ステータス／種類で絞り込みます
get_bank_account / list_bank_accounts	銀行口座の詳細を取得し、顧客で絞り込みます
get_wallet / list_wallets	ウォレットの詳細を取得し、顧客で絞り込みます
get_virtual_account / list_virtual_accounts	仮想口座の詳細と入金手順を取得します
list_virtual_account_transfers	仮想口座の入金と変換の一覧を取得します
get_offloader_wallet / list_offloader_wallets	オフローダーウォレットの詳細とオフランプ設定を取得します
get_webhook	Webhook の詳細と配信状況を取得します
get_event	イベントの詳細と Webhook 配信記録を取得します

対応する通貨とネットワーク

通貨	種類
usd, eur	法定通貨
usdc, usdt, eurc	ステーブルコイン

ネットワーク	種類
ach, wire, sepa	法定通貨決済網
ethereum, polygon, sol, base, arbitrum, tron, avalanche, optimism	ブロックチェーン

インストール

前提条件

• Python 3.12+
• SpherePay API キー（こちらから取得）

Claude Desktop（stdio）

Claude Desktop の設定（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "spherepay": {
      "command": "uvx",
      "args": ["spherepay-mcp"],
      "env": {
        "SPHEREPAY_BASE_URL": "https://api.sandbox.spherepay.co",
        "SPHEREPAY_API_KEY": "your_api_key_here"
      }
    }
  }
}

デスクトップ拡張機能

GitHub Releasesから最新の.mcpbファイルをダウンロードし、ダブルクリックして Claude Desktop にインストールします。

スタンドアロン

git clone https://github.com/danchev/spherepay-mcp.git
cd spherepay-mcp
uv sync
uv run spherepay-mcp

設定

変数	必須	デフォルト	説明
SPHEREPAY_API_KEY	はい	—	SpherePay API キー（Bearer トークン）
SPHEREPAY_BASE_URL	いいえ	https://api.sandbox.spherepay.co	API のベース URL。本番環境では https://api.spherepay.co を使用します
SPHEREPAY_TIMEOUT	いいえ	30	リクエストのタイムアウト（秒）
SPHEREPAY_MAX_RETRIES	いいえ	3	一時的な障害（429、5xx）に対する最大リトライ回数

ライセンス

AGPL-3.0 ライセンス。詳細は LICENSE をご覧ください。