MSP360

MSP360 MCP Server

MCP server for MSP360's Managed Backup Service API (formerly CloudBerry Lab) - companies, managed computers, backup plans, monitoring, and licenses, for AI assistants and the WYRE Conduit gateway.

Authentication

Provide the Managed Backup Service provider-portal UserName/Password pair. This server exchanges it for a short-lived bearer token via POST /api/Provider/Login and caches it, re-authenticating automatically whenever the vendor rejects the cached token (HTTP 401) - callers only ever need to supply the long-lived username/password.

Configuration

Request limits

• HTTP request bodies are capped at 256 KiB (262144 bytes). After the X-Gateway-S2S check passes, a Content-Length above the cap returns 413 with a JSON-RPC error; bodies without Content-Length are capped by the MCP SDK transport. Unauthenticated requests still get 401 first.
• tools/call arguments are capped at 10,000 elements (every array item and object key at any depth). Larger inputs return an isError tool result and are never dispatched.

These limits address CVE-2026-111768 / GHSA-46jr-4wx8-v453 (memory exhaustion during validation) and GHSA-f897-62hf-6gxq (no request body / batch cap).

Tools

Companies

• msp360_list_companies - list companies (customer organizations) under this provider account.
• msp360_get_company - get a single company by ID.

Computers

• msp360_list_computers - paginated list of managed computers (endpoints).
• msp360_get_computer - get a single computer by HID.

Backup Plans

• msp360_list_plans - list backup/restore plans on a computer.
• msp360_get_plan - get a single plan by ID.
• msp360_get_plan_info - get status/info for a plan.
• msp360_get_plan_history - get run history for a plan, optionally filtered to a date.
• msp360_start_plan - start a backup run for a plan.
• msp360_stop_plan - stop a currently running backup for a plan.

Monitoring

• msp360_get_monitoring - status data for the latest plan runs on all endpoints.
• msp360_get_monitoring_for_user - status data for the latest plan runs, filtered by user.

Licenses

• msp360_list_licenses - list available licenses, optionally filtered to unassigned ones.
• msp360_get_license - get a single license by ID.

Scope

This is a v1 / MVP surface covering the core "what's backed up and is it healthy" MSP workflow. Explicitly out of scope for now: Administrators, Billing, Builds, Packages, Destinations/Accounts (storage-provisioning config), Users/Authenticate, and License Grant/Release/Revoke (mutating license assignment) and computer authorization/de-authorization - these are provider/reseller-admin-console-level operations with real billing/access consequences, distinct from day-to-day MSP monitoring, and worth a deliberate separate decision later rather than bundling into v1.

Development

npm installnpm run buildnpm testnpm run lint   # tsc --noEmit

Docker

docker build -t msp360-mcp .docker run -p 8080:8080 -e MSP360_USERNAME=... -e MSP360_PASSWORD=... msp360-mcp