Skip to main content
Glama
danchev

SpherePay MCP Server

by danchev
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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

Related MCP server: BlindPay MCP Server

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

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.

Install Server
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • BlindPay MCP Server

    blindpaylabs
    A
    license
    -
    quality
    A
    maintenance
    Enables AI assistants to interact with BlindPay's stablecoin payment infrastructure, allowing users to create receivers, process payouts and payins across multiple blockchains, manage virtual accounts and wallets, and configure payment operations through natural language.
    Last updated
    715
    9
    MIT
  • Cresium MCP Server by Cresium

    Cresium MCP Serverofficial

    Cresium
    F
    license
    A
    quality
    C
    maintenance
    Enables AI tools to manage financial operations through the Cresium Partner API, including transactions, payments, invoices, and wallet balances. It supports secure workflows such as bank address lookups, transfer previews, and signature request management.
    Last updated
    12
    2

View all related MCP servers

Related MCP Connectors

  • AgentPay

    Agent payments, API key vaulting, and governed mandates. Agents spend within user-defined limits.

  • Didit MCP Server

    KYC, KYB, AML, wallet screening, transaction monitoring, and fraud workflows for AI agents.

  • EU Compliance Tools (pay-per-call, x402)

    Agent bookkeeping, sanctions, KYB, VAT and e-invoice checks - pay per call in USDC

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/danchev/spherepay-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server