Manage SpherePay customers, bank accounts, wallets, and transfers from Claude.
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.
| 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 |
| 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 |
| 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 |
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"
}
}
}
}
Download the latest .mcpb file from GitHub Releases and double-click to install in Claude Desktop.
git clone https://github.com/danchev/spherepay-mcp.git
cd spherepay-mcp
uv sync
uv run spherepay-mcp
| 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) |
AGPL-3.0 License. See LICENSE for details.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
uvx spherepay-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-danchev-spherepay": {
"command": "uvx",
"args": [
"spherepay-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencespherepay-mcppypiSpherePay works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.