English Français العربية

SpherePay

Registre officiel Finance et paiements

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

Code source Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • SPHEREPAY_API_KEY obligatoire secret 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)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que SpherePay ?

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

Comment installer SpherePay ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour SpherePay ?

Oui. Il attend SPHEREPAY_API_KEY, à renseigner dans sa configuration.

SpherePay est-il open source ?

Oui. Son code est sur GitHub sous licence AGPL-3.0.

Qui maintient SpherePay ?

Il est publié par danchev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.