English Français العربية

SpherePay

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع SpherePay؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package spherepay-mcp
Claude Code 
claude mcp add spherepay -e 'SPHEREPAY_API_KEY=<your spherepay_api_key>' -e 'SPHEREPAY_BASE_URL=<SPHEREPAY_BASE_URL>' -e 'SPHEREPAY_TIMEOUT=<SPHEREPAY_TIMEOUT>' -e 'SPHEREPAY_MAX_RETRIES=<SPHEREPAY_MAX_RETRIES>' -- uvx spherepay-mcp==0.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spherepay": {
            "command": "uvx",
            "args": [
                "spherepay-mcp==0.0.1"
            ],
            "env": {
                "SPHEREPAY_API_KEY": "<your spherepay_api_key>",
                "SPHEREPAY_BASE_URL": "<SPHEREPAY_BASE_URL>",
                "SPHEREPAY_TIMEOUT": "<SPHEREPAY_TIMEOUT>",
                "SPHEREPAY_MAX_RETRIES": "<SPHEREPAY_MAX_RETRIES>"
            }
        }
    }
}

متغيرات البيئة

  • SPHEREPAY_API_KEY إلزامي سري Your SpherePay API key (Bearer token). Get one at https://dashboard.spherepay.co
  • SPHEREPAY_BASE_URL API base URL. Use https://api.sandbox.spherepay.co for testing or https://api.spherepay.co for production.
  • SPHEREPAY_TIMEOUT Request timeout in seconds (default: 30)
  • SPHEREPAY_MAX_RETRIES Maximum retry attempts for transient failures (default: 3)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SpherePay MCP Server
  2. Features
  3. Tools
  4. Supported Currencies and Networks
  5. Installation
  6. Configuration
  7. License

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):

{
  "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
git clone https://github.com/danchev/spherepay-mcp.git
cd spherepay-mcp
uv sync
uv 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.

الأسئلة الشائعة

ما هو SpherePay؟

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

كيف أثبّت SpherePay؟

يعمل على جهازك. في Claude Code: claude mcp add spherepay -e 'SPHEREPAY_API_KEY=<your spherepay_api_key>' -e 'SPHEREPAY_BASE_URL=<SPHEREPAY_BASE_URL>' -e 'SPHEREPAY_TIMEOUT=<SPHEREPAY_TIMEOUT>' -e 'SPHEREPAY_MAX_RETRIES=<SPHEREPAY_MAX_RETRIES>' -- uvx spherepay-mcp==0.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SpherePay إلى مفتاح API؟

نعم. يتطلب SPHEREPAY_API_KEY، وتضبطها في إعداداته.

هل SpherePay مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص AGPL-3.0.

من يصون SpherePay؟

ينشره danchev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.