SpherePay

io.github.danchev由 GitHub 帳號 danchev 發布v0.0.1更新於 Oct 24, 2026

Manage SpherePay customers, bank accounts, wallets, and transfers from Claude.

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

SpherePay MCP 伺服器讓助手在 Claude 中管理 SpherePay 的客戶、銀行帳戶、錢包、轉帳、虛擬帳戶與 webhook。

可以做什麼
建立並驗證個人或企業客戶及企業代表，產生 KYC 連結並完成 OTP 與人臉驗證，同時設定銀行帳戶或加密錢包等資金工具。在資金工具之間執行具冪等保護的轉帳，並提交 CCTP 跨鏈出金交易。建立用於法幣兌換穩定幣的虛擬帳戶，以及用於穩定幣兌換法幣的出金錢包。透過 HTTPS webhook 訂閱事件通知。查詢客戶、轉帳、銀行帳戶、錢包、虛擬帳戶、出金錢包、webhook 與事件，可依客戶、狀態或類型篩選。
適用情境
適合在 Claude 中以對話方式操作 SpherePay 支付業務：客戶入駐與驗證、開設帳戶與錢包、轉移資金，或查看轉帳與 webhook 狀態。建議先在沙箱環境試用。
執行需求
以 Python 套件形式在本機執行（需 Python 3.12+），可透過 uvx 或 Claude Desktop 擴充功能安裝。需要 SpherePay API 金鑰，放在 SPHEREPAY_API_KEY 中。選用設定：SPHEREPAY_BASE_URL（預設為沙箱位址）、SPHEREPAY_TIMEOUT 與 SPHEREPAY_MAX_RETRIES。需要連線至 SpherePay API 的網路存取。
安裝前請注意
SPHEREPAY_API_KEY 是支付平台的 Bearer 憑證，請勿寫入共用設定。相關工具會建立客戶、帳戶、錢包與 webhook，並執行真實資金轉帳與 CCTP 出金，可能實際移動資金。確認前請將 SPHEREPAY_BASE_URL 指向沙箱。客戶資料（含 KYC 與身分驗證資訊）會傳送給 SpherePay。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SpherePay，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

SpherePay MCP Server

A Model Context Protocol server for the SpherePay payment platform. Manage customers, bank accounts, wallets, transfers, virtual accounts, webhooks, and CCTP off-ramps directly from Claude.

Features

  • 24 curated tools — 9 workflow tools for multi-step operations, 15 read-only tools for instant lookups
  • Automatic retries with exponential backoff and rate limit handling
  • Idempotency for transfers — duplicate requests are safely deduplicated
  • PII redaction in logs — account numbers, routing numbers, and personal data are never logged
  • Input validation at the tool boundary — IDs, currencies, networks, and amounts are validated before any API call
  • Desktop Extension (.mcpb) for one-click Claude Desktop installation

Tools

Workflow Tools

ToolDescription
onboard_customerCreate a customer (individual or business) and generate TOS/KYC verification links
verify_customerTwo-step verification: send OTP, then verify with face recognition
setup_fundingCreate a bank account (USD/EUR) or crypto wallet for a customer
execute_transferTransfer money between funding instruments with automatic idempotency
onboard_business_repCreate and verify a business representative
setup_virtual_accountCreate a virtual account for automatic fiat-to-stablecoin conversion
setup_offloader_walletCreate an offloader wallet for stablecoin-to-fiat off-ramp
create_webhookSubscribe to event notifications via HTTPS webhooks
submit_cctp_offrampSubmit a CCTP burn transaction for cross-chain off-ramp redemption

Read-Only Tools

ToolDescription
get_customer / list_customersRetrieve customer details and verification status
get_transfer / list_transfersRetrieve transfers with status, filter by customer/status/type
get_bank_account / list_bank_accountsRetrieve bank account details, filter by customer
get_wallet / list_walletsRetrieve wallet details, filter by customer
get_virtual_account / list_virtual_accountsRetrieve virtual account details and deposit instructions
list_virtual_account_transfersList deposits and conversions for a virtual account
get_offloader_wallet / list_offloader_walletsRetrieve offloader wallet details and off-ramp config
get_webhookRetrieve webhook details and delivery status
get_eventRetrieve event details and webhook delivery records

Supported Currencies and Networks

CurrencyType
usd, eurFiat
usdc, usdt, eurcStablecoin
NetworkType
ach, wire, sepaFiat rails
ethereum, polygon, sol, base, arbitrum, tron, avalanche, optimismBlockchain

Installation

Prerequisites

Claude Desktop (stdio)

Add to your Claude Desktop config (claude_desktop_config.json):

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

Desktop Extension

Download the latest .mcpb file from GitHub Releases and double-click to install in Claude Desktop.

Standalone

bash
git clone https://github.com/danchev/spherepay-mcp.gitcd spherepay-mcpuv syncuv run spherepay-mcp

Configuration

VariableRequiredDefaultDescription
SPHEREPAY_API_KEYYes—Your SpherePay API key (Bearer token)
SPHEREPAY_BASE_URLNohttps://api.sandbox.spherepay.coAPI base URL. Use https://api.spherepay.co for production
SPHEREPAY_TIMEOUTNo30Request timeout in seconds
SPHEREPAY_MAX_RETRIESNo3Max retry attempts for transient failures (429, 5xx)

License

AGPL-3.0 License. See LICENSE for details.

來源：README.md，提交 927f101

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分