{
  "markdown": "# SpherePay MCP Server\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server for the [SpherePay](https://spherepay.co) payment platform. Manage customers, bank accounts, wallets, transfers, virtual accounts, webhooks, and CCTP off-ramps directly from Claude.\n\n## Features\n\n- **24 curated tools** — 9 workflow tools for multi-step operations, 15 read-only tools for instant lookups\n- **Automatic retries** with exponential backoff and rate limit handling\n- **Idempotency** for transfers — duplicate requests are safely deduplicated\n- **PII redaction** in logs — account numbers, routing numbers, and personal data are never logged\n- **Input validation** at the tool boundary — IDs, currencies, networks, and amounts are validated before any API call\n- **Desktop Extension** (.mcpb) for one-click Claude Desktop installation\n\n## Tools\n\n### Workflow Tools\n\n| Tool | Description |\n|------|-------------|\n| `onboard_customer` | Create a customer (individual or business) and generate TOS/KYC verification links |\n| `verify_customer` | Two-step verification: send OTP, then verify with face recognition |\n| `setup_funding` | Create a bank account (USD/EUR) or crypto wallet for a customer |\n| `execute_transfer` | Transfer money between funding instruments with automatic idempotency |\n| `onboard_business_rep` | Create and verify a business representative |\n| `setup_virtual_account` | Create a virtual account for automatic fiat-to-stablecoin conversion |\n| `setup_offloader_wallet` | Create an offloader wallet for stablecoin-to-fiat off-ramp |\n| `create_webhook` | Subscribe to event notifications via HTTPS webhooks |\n| `submit_cctp_offramp` | Submit a CCTP burn transaction for cross-chain off-ramp redemption |\n\n### Read-Only Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_customer` / `list_customers` | Retrieve customer details and verification status |\n| `get_transfer` / `list_transfers` | Retrieve transfers with status, filter by customer/status/type |\n| `get_bank_account` / `list_bank_accounts` | Retrieve bank account details, filter by customer |\n| `get_wallet` / `list_wallets` | Retrieve wallet details, filter by customer |\n| `get_virtual_account` / `list_virtual_accounts` | Retrieve virtual account details and deposit instructions |\n| `list_virtual_account_transfers` | List deposits and conversions for a virtual account |\n| `get_offloader_wallet` / `list_offloader_wallets` | Retrieve offloader wallet details and off-ramp config |\n| `get_webhook` | Retrieve webhook details and delivery status |\n| `get_event` | Retrieve event details and webhook delivery records |\n\n## Supported Currencies and Networks\n\n| Currency | Type |\n|----------|------|\n| `usd`, `eur` | Fiat |\n| `usdc`, `usdt`, `eurc` | Stablecoin |\n\n| Network | Type |\n|---------|------|\n| `ach`, `wire`, `sepa` | Fiat rails |\n| `ethereum`, `polygon`, `sol`, `base`, `arbitrum`, `tron`, `avalanche`, `optimism` | Blockchain |\n\n## Installation\n\n### Prerequisites\n\n- Python 3.12+\n- A SpherePay API key ([get one here](https://spherepay.co/dashboard))\n\n### Claude Desktop (stdio)\n\nAdd to your Claude Desktop config (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"spherepay\": {\n      \"command\": \"uvx\",\n      \"args\": [\"spherepay-mcp\"],\n      \"env\": {\n        \"SPHEREPAY_BASE_URL\": \"https://api.sandbox.spherepay.co\",\n        \"SPHEREPAY_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Desktop Extension\n\nDownload the latest `.mcpb` file from [GitHub Releases](https://github.com/danchev/spherepay-mcp/releases) and double-click to install in Claude Desktop.\n\n### Standalone\n\n```bash\ngit clone https://github.com/danchev/spherepay-mcp.git\ncd spherepay-mcp\nuv sync\nuv run spherepay-mcp\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `SPHEREPAY_API_KEY` | Yes | — | Your SpherePay API key (Bearer token) |\n| `SPHEREPAY_BASE_URL` | No | `https://api.sandbox.spherepay.co` | API base URL. Use `https://api.spherepay.co` for production |\n| `SPHEREPAY_TIMEOUT` | No | `30` | Request timeout in seconds |\n| `SPHEREPAY_MAX_RETRIES` | No | `3` | Max retry attempts for transient failures (429, 5xx) |\n\n## License\n\nAGPL-3.0 License. See [LICENSE](LICENSE) for details.\n\n<!-- mcp-name: io.github.danchev/spherepay -->\n",
  "bytes": 4311,
  "sha": "3b89ff19cfadcd73d64010924d207fda9cbaf07a6982f46edd8edff27980b3d9",
  "repo_slug": "danchev/spherepay-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_danchev_spherepay_8dd56a8f/readme"
}