Manage SpherePay customers, bank accounts, wallets, and transfers from Claude.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
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
| Tool | Description |
|---|---|
onboard_customer | Create a customer (individual or business) and generate TOS/KYC verification links |
verify_customer | Two-step verification: send OTP, then verify with face recognition |
setup_funding | Create a bank account (USD/EUR) or crypto wallet for a customer |
execute_transfer | Transfer money between funding instruments with automatic idempotency |
onboard_business_rep | Create and verify a business representative |
setup_virtual_account | Create a virtual account for automatic fiat-to-stablecoin conversion |
setup_offloader_wallet | Create an offloader wallet for stablecoin-to-fiat off-ramp |
create_webhook | Subscribe to event notifications via HTTPS webhooks |
submit_cctp_offramp | Submit a CCTP burn transaction for cross-chain off-ramp redemption |
Read-Only Tools
| Tool | Description |
|---|---|
get_customer / list_customers | Retrieve customer details and verification status |
get_transfer / list_transfers | Retrieve transfers with status, filter by customer/status/type |
get_bank_account / list_bank_accounts | Retrieve bank account details, filter by customer |
get_wallet / list_wallets | Retrieve wallet details, filter by customer |
get_virtual_account / list_virtual_accounts | Retrieve virtual account details and deposit instructions |
list_virtual_account_transfers | List deposits and conversions for a virtual account |
get_offloader_wallet / list_offloader_wallets | Retrieve offloader wallet details and off-ramp config |
get_webhook | Retrieve webhook details and delivery status |
get_event | Retrieve event details and webhook delivery records |
Supported Currencies and Networks
| Currency | Type |
|---|---|
usd, eur | Fiat |
usdc, usdt, eurc | Stablecoin |
| Network | Type |
|---|---|
ach, wire, sepa | Fiat rails |
ethereum, polygon, sol, base, arbitrum, tron, avalanche, optimism | Blockchain |
Installation
Prerequisites
- Python 3.12+
- A SpherePay API key (get one here)
Claude Desktop (stdio)
Add to your Claude Desktop config (claude_desktop_config.json):
Desktop Extension
Download the latest .mcpb file from GitHub Releases and double-click to install in Claude Desktop.
Standalone
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
SPHEREPAY_API_KEY | Yes | — | Your SpherePay API key (Bearer token) |
SPHEREPAY_BASE_URL | No | https://api.sandbox.spherepay.co | API base URL. Use https://api.spherepay.co for production |
SPHEREPAY_TIMEOUT | No | 30 | Request timeout in seconds |
SPHEREPAY_MAX_RETRIES | No | 3 | Max retry attempts for transient failures (429, 5xx) |
License
AGPL-3.0 License. See LICENSE for details.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about SpherePay
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/spherepay)HTML Embed
<a href="https://allmcps.com/mcp/spherepay"><img src="https://allmcps.com/api/badge/spherepay?style=directory" alt="SpherePay on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
35Quality signal: Fair · 35/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools15/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.