oci ghcr.io/wyre-ai/spanning-mcp:v1.1.4stdioApache-2.0updated 8d ago
A Model Context Protocol server exposing the Spanning Cloud Backup API to Claude and other MCP clients.
What can you do with Spanning Cloud Backup?
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.
Install
Add Spanning Cloud Backup to your client. Pick the one you use.
claude mcp add ghcr-io-wyre-ai-spanning-mcp-v1-1-4 -- docker run -i --rm ghcr.io/wyre-ai/spanning-mcp:v1.1.4codex mcp add ghcr-io-wyre-ai-spanning-mcp-v1-1-4 -- docker run -i --rm ghcr.io/wyre-ai/spanning-mcp:v1.1.4amp mcp add ghcr-io-wyre-ai-spanning-mcp-v1-1-4 -- docker run -i --rm ghcr.io/wyre-ai/spanning-mcp:v1.1.4{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"ghcr-io-wyre-ai-spanning-mcp-v1-1-4","command":"docker","args":["run","-i","--rm","ghcr.io/wyre-ai/spanning-mcp:v1.1.4"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"type": "local",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"ghcr-io-wyre-ai-spanning-mcp-v1-1-4": {
"command": {
"path": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wyre-ai/spanning-mcp:v1.1.4"
]
}
}
}
}Add to your Zed `settings.json`.
docker run -i --rm ghcr.io/wyre-ai/spanning-mcp:v1.1.4Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
9 tools
Spanning Cloud Backup exposes 9 tools to a connected agent.
- 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
Score
75 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust16/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 9 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.1.4Latest | Aug 26, 2026 |