SpherePay MCP Server
Enables users to manage the SpherePay payment platform, including customer onboarding, bank and wallet management, and cross-chain transfers. It provides tools for executing financial workflows, tracking transfers, and configuring virtual accounts for fiat-to-stablecoin conversions.
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
| 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):
{
"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
| 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.
<!-- mcp-name: io.github.danchev/spherepay -->
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.