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_user renders 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 via window.__BRAND__ injection or MCP_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 with npm run build:ui after editing ui/.

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 of m365 | 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.