English Français العربية

SpherePay

Official registry Finance and payments

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

Source code Documentation

What can you do with 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • SPHEREPAY_API_KEY required 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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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

Frequently asked questions

What is SpherePay?

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

How do I install SpherePay?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SpherePay need an API key?

Yes. It expects SPHEREPAY_API_KEY, which you set in its configuration.

Is SpherePay open source?

Yes. Its code is on GitHub under the AGPL-3.0 license.

Who maintains SpherePay?

It is published by danchev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.