Spanning Cloud Backup MCP Server
A Model Context Protocol server exposing the Spanning Cloud Backup API to Claude and other MCP clients.
What it does
Surface SaaS backup posture for your M365, Google Workspace, or Salesforce tenants directly to AI assistants — list backed-up users, inspect covered services, browse backup history, queue restores, and audit admin activity and license usage.
- Interactive backup status card (MCP Apps, SEP-1865):
spanning_get_userrenders as a read-only interactive card in MCP Apps hosts (Claude Desktop/web) showing the user's backup status, license state, last backup, and per-service coverage; neutral by default, brandable viawindow.__BRAND__injection orMCP_BRAND_*env vars (MCP_BRAND_NAME,MCP_BRAND_LOGO_URL,MCP_BRAND_PRIMARY_COLOR,MCP_BRAND_ACCENT_COLOR,MCP_BRAND_BG,MCP_BRAND_TEXT). Plain-JSON behavior is unchanged in other hosts. Rebuild the embedded card withnpm run build:uiafter editingui/.
Tools
| Tool | Purpose |
|---|---|
spanning_list_users | List backed-up users in the org |
spanning_get_user | Fetch a single user's detail |
spanning_list_services | List services covered for a user |
spanning_list_backups | List backup runs for a user + service |
spanning_queue_restore | Queue a restore (DESTRUCTIVE — requires confirmation) |
spanning_get_restore_status | Check restore progress |
spanning_list_audit_log | Admin audit log (date-range elicitation) |
spanning_get_license_usage | Seats used vs purchased |
spanning_status | Server status / health |
Credentials
Local (env mode)
export SPANNING_PLATFORM="m365" # or "gws" or "salesforce"
export SPANNING_ADMIN_EMAIL="..."
export SPANNING_API_TOKEN="..."
Hosted (gateway mode)
The WYRE MCP Gateway injects credentials per request via headers:
X-Spanning-Platform(required, one ofm365|gws|salesforce)X-Spanning-Admin-Email(required)X-Spanning-API-Token(required, secret)
Run
npm install
npm run build
npm start # stdio
MCP_TRANSPORT=http npm start # HTTP on :8080
License
Apache 2.0 — see LICENSE.