danchev avatar

SpherePay

danchev/spherepay-mcp

Connects Claude to the SpherePay payment platform API with 24 tools covering customer onboarding, KYC verification, bank account and crypto wallet setup, and transfers across fiat and stablecoin rails. You get workflow tools that handle multi-step operations like customer verification with OTP and face recognition, virtual account creation for fiat-to-stablecoin conversion, and CCTP off-ramp submissions. The read-only tools let you query customers, transfers, wallets, and webhooks. Built with automatic retries, idempotent transfers, PII redaction in logs, and input validation for IDs, amounts, and networks. Supports ACH, SEPA, wire transfers alongside Ethereum, Polygon, Solana, Base, and other blockchain networks for USDC, USDT, and EURC.

tools
24
auth
Secret needed
transport
STDIO
env vars
4
last updated
Mar 7, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

onboard_customerCreate a customer (individual or business) and generate TOS/KYC verification links

Create a customer (individual or business) and generate TOS/KYC verification links

No parameter schema in public metadata yet.

verify_customerTwo-step verification: send OTP, then verify with face recognition

Two-step verification: send OTP, then verify with face recognition

No parameter schema in public metadata yet.

setup_fundingCreate a bank account (USD/EUR) or crypto wallet for a customer

Create a bank account (USD/EUR) or crypto wallet for a customer

No parameter schema in public metadata yet.

execute_transferTransfer money between funding instruments with automatic idempotency

Transfer money between funding instruments with automatic idempotency

No parameter schema in public metadata yet.

onboard_business_repCreate and verify a business representative

Create and verify a business representative

No parameter schema in public metadata yet.

setup_virtual_accountCreate a virtual account for automatic fiat-to-stablecoin conversion

Create a virtual account for automatic fiat-to-stablecoin conversion

No parameter schema in public metadata yet.

setup_offloader_walletCreate an offloader wallet for stablecoin-to-fiat off-ramp

Create an offloader wallet for stablecoin-to-fiat off-ramp

No parameter schema in public metadata yet.

create_webhookSubscribe to event notifications via HTTPS webhooks

Subscribe to event notifications via HTTPS webhooks

No parameter schema in public metadata yet.

submit_cctp_offrampSubmit a CCTP burn transaction for cross-chain off-ramp redemption

Submit a CCTP burn transaction for cross-chain off-ramp redemption

No parameter schema in public metadata yet.

get_customerRetrieve customer details and verification status

Retrieve customer details and verification status

No parameter schema in public metadata yet.

list_customersRetrieve customer details and verification status

Retrieve customer details and verification status

No parameter schema in public metadata yet.

get_transferRetrieve transfers with status, filter by customer/status/type

Retrieve transfers with status, filter by customer/status/type

No parameter schema in public metadata yet.

list_transfersRetrieve transfers with status, filter by customer/status/type

Retrieve transfers with status, filter by customer/status/type

No parameter schema in public metadata yet.

get_bank_accountRetrieve bank account details, filter by customer

Retrieve bank account details, filter by customer

No parameter schema in public metadata yet.

list_bank_accountsRetrieve bank account details, filter by customer

Retrieve bank account details, filter by customer

No parameter schema in public metadata yet.

get_walletRetrieve wallet details, filter by customer

Retrieve wallet details, filter by customer

No parameter schema in public metadata yet.

list_walletsRetrieve wallet details, filter by customer

Retrieve wallet details, filter by customer

No parameter schema in public metadata yet.

get_virtual_accountRetrieve virtual account details and deposit instructions

Retrieve virtual account details and deposit instructions

No parameter schema in public metadata yet.

list_virtual_accountsRetrieve virtual account details and deposit instructions

Retrieve virtual account details and deposit instructions

No parameter schema in public metadata yet.

list_virtual_account_transfersList deposits and conversions for a virtual account

List deposits and conversions for a virtual account

No parameter schema in public metadata yet.

get_offloader_walletRetrieve offloader wallet details and off-ramp config

Retrieve offloader wallet details and off-ramp config

No parameter schema in public metadata yet.

list_offloader_walletsRetrieve offloader wallet details and off-ramp config

Retrieve offloader wallet details and off-ramp config

No parameter schema in public metadata yet.

get_webhookRetrieve webhook details and delivery status

Retrieve webhook details and delivery status

No parameter schema in public metadata yet.

get_eventRetrieve event details and webhook delivery records

Retrieve event details and webhook delivery records

No parameter schema in public metadata yet.

Sponsors

Configuration

SPHEREPAY_API_KEY*secret

Your SpherePay API key (Bearer token). Get one at https://dashboard.spherepay.co

SPHEREPAY_BASE_URL

API base URL. Use https://api.sandbox.spherepay.co for testing or https://api.spherepay.co for production.

SPHEREPAY_TIMEOUT

Request timeout in seconds (default: 30)

SPHEREPAY_MAX_RETRIES

Maximum retry attempts for transient failures (default: 3)

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


View the full README on GitHub

Details

Repository
github.com/danchev/spherepay-mcp
Package
spherepay-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active