SpherePay MCP Server

by danchevio.github.danchev/spherepayv0.0.1

Manage SpherePay customers, bank accounts, wallets, and transfers from Claude.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale7mo ago

Install SpherePay MCP server

claude mcp add spherepay -e SPHEREPAY_API_KEY='<spherepay-api-key>' -- uvx spherepay-mcp

{
  "mcpServers": {
    "spherepay": {
      "command": "uvx",
      "args": [
        "spherepay-mcp"
      ],
      "env": {
        "SPHEREPAY_API_KEY": "<spherepay-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "spherepay": {
      "command": "uvx",
      "args": [
        "spherepay-mcp"
      ],
      "env": {
        "SPHEREPAY_API_KEY": "<spherepay-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "spherepay": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "spherepay-mcp"
      ],
      "env": {
        "SPHEREPAY_API_KEY": "<spherepay-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "spherepay": {
      "command": "uvx",
      "args": [
        "spherepay-mcp"
      ],
      "env": {
        "SPHEREPAY_API_KEY": "<spherepay-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
SPHEREPAY_API_KEY	yes	yes	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)

Freshness

Stale — last maintenance signal 7mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-03-07 · 7mo ago · GitHub
Latest release
2026-03-07 · 7mo ago · GitHub · 0.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-03-07 · 7mo ago · official registry · v0.0.1

FAQ

›How do I install the SpherePay MCP server in Claude Code?

Run: claude mcp add spherepay -e SPHEREPAY_API_KEY='<spherepay-api-key>' -- uvx spherepay-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does SpherePay require an API key?

Yes. It expects SPHEREPAY_API_KEY, of which 1 is a secret.

›Can I use SpherePay as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is SpherePay in the official MCP registry?

Yes, as io.github.danchev/spherepay.