SpherePay

io.github.danchevPublished by GitHub account danchevv0.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

SpherePay MCP server lets an assistant manage SpherePay customers, bank accounts, wallets, transfers, virtual accounts and webhooks from Claude.

What you can do
Onboard and verify customers and business representatives, including KYC links and OTP/face verification steps, and set up funding instruments such as bank accounts and crypto wallets. Move money between funding instruments with idempotent transfers, and submit CCTP cross-chain off-ramp transactions. Create virtual accounts for fiat-to-stablecoin conversion and offloader wallets for stablecoin-to-fiat off-ramp. Subscribe to event notifications through HTTPS webhooks. Look up customers, transfers, bank accounts, wallets, virtual accounts, offloader wallets, webhooks and events, with filtering by customer, status or type.
When to use it
Useful when you want to drive SpherePay payment operations conversationally from Claude: onboarding and verifying customers, setting up accounts and wallets, moving funds, or checking transfer and webhook status. Best tried first against the sandbox base URL.
Requirements
Runs locally as a Python package (Python 3.12+) via uvx or a Claude Desktop extension. Requires a SpherePay API key in SPHEREPAY_API_KEY. Optional settings: SPHEREPAY_BASE_URL (defaults to the sandbox), SPHEREPAY_TIMEOUT and SPHEREPAY_MAX_RETRIES. Network access to the SpherePay API.
Before you install
The API key in SPHEREPAY_API_KEY is a bearer credential for a payments platform; keep it out of shared configs. Tools create customers, accounts, wallets and webhooks, and execute real money transfers and CCTP off-ramps, which can move funds. Point SPHEREPAY_BASE_URL at the sandbox until you are confident. Customer data, including KYC and identity verification, is sent to SpherePay.

Installation

In SourceWeft

  1. Open SpherePay in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit 927f101

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts