SpherePay MCP Server

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

Local serverstdioPython

What is the SpherePay MCP Server?

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

What it actually does

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

  • 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

Configuration

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
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
list_virtual_account_transfersList deposits and conversions for a virtual account
get_webhookRetrieve webhook details and delivery status
get_eventRetrieve event details and webhook delivery records

How to install the SpherePay MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SPHEREPAY_BASE_URLEndpoint or connection string the server talks to.Yes
SPHEREPAY_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use SpherePay to onboard customer.”
  • “Use SpherePay to verify customer.”
  • “Use SpherePay to setup funding.”

Frequently asked questions

Manage SpherePay customers, bank accounts, wallets, and transfers from Claude. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.