kaseya-vsa-mcp
Kaseya VSA MCP Server
Model Context Protocol (MCP) server for the Kaseya VSA RMM API. Exposes managed endpoints, software / hardware inventory, patch state, agent procedures, alarms, Service Desk tickets, organizations, and machine groups to AI assistants.
Tools
Tool | Description |
| List managed endpoints (agents). Optional |
| Get an agent's details by ID (renders as an interactive card in MCP Apps hosts). |
| Installed software for an agent. |
| Hardware audit for an agent. |
| Pending and installed patches for an agent. |
| Force a patch deploy on an agent (destructive — confirmation required). |
| Agent procedures available to run. |
| Execute a procedure on an agent (destructive — confirmation required). |
| Open alarms (optional state filter; date-window elicitation if missing). |
| Service Desk tickets (returns a friendly message if SD module isn't enabled). |
| Tenant organizations. |
| Machine group hierarchy. |
When the user omits required filters or runs a destructive action, the server uses MCP elicitation to prompt for choices or confirm.
Interactive device card (MCP Apps)
kaseya_vsa_get_agent renders as a read-only interactive device card in MCP
Apps hosts (Claude Desktop/web), showing the endpoint's name, online status,
organization, machine group, OS, IP address, and last check-in. The card is
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) applied at serve time. Plain-JSON behavior is unchanged in
other hosts. After editing ui/, regenerate the embedded bundle with
npm run build:ui.
Related MCP server: kaseya-bms-mcp
Configuration
Environment-variable mode (default)
Variable | Required | Description |
| yes | Full base URL incl. |
| one of | Local-auth username |
| one of | Local-auth password (secret) |
| one of | Kaseya One SSO token (alternative to username + password) |
| no |
|
| no | HTTP listen port (default |
| no |
|
Either the username + password pair OR the KASEYA_VSA_K1_TOKEN is required.
Gateway mode
When deployed behind the WYRE MCP Gateway, set AUTH_MODE=gateway and the
server will read credentials from per-request HTTP headers:
X-Kaseya-VSA-Tenant-Url(required)X-Kaseya-VSA-Username(with password)X-Kaseya-VSA-Password(with username)X-Kaseya-VSA-K1-Token(alternative to username + password)
Each request creates a fresh server instance with isolated credentials — no
cross-tenant process.env pollution.
Local development
npm install
npm run build
KASEYA_VSA_TENANT_URL=https://vsa.example.com/api/v1.0 \
KASEYA_VSA_USERNAME=... \
KASEYA_VSA_PASSWORD=... \
npm startRun as HTTP for testing:
MCP_TRANSPORT=http npm start
curl http://localhost:8080/healthDocker
docker build -t kaseya-vsa-mcp .
docker run --rm -p 8080:8080 \
-e KASEYA_VSA_TENANT_URL=https://vsa.example.com/api/v1.0 \
-e KASEYA_VSA_USERNAME=... \
-e KASEYA_VSA_PASSWORD=... \
kaseya-vsa-mcpLicense
Apache-2.0
This server cannot be deployed
Maintenance
Related MCP Connectors
- mttrlyOAuthcom.mttrly
AI-powered incident management and server monitoring via MCP.
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
MCP server enabling AI agents to manage Bitrix24 features via standardized protocol
Related MCP Servers
- FlicenseAqualityCmaintenanceAn MCP server that connects AI assistants to the NinjaOne remote monitoring and management platform via the REST API v2. It provides tools for device inventory, organization management, alert handling, maintenance scheduling, and automated job execution.221-
- AlicenseNot gradedqualityAmaintenanceMCP server for Kaseya BMS PSA — tickets, accounts, time entries, and contracts. Enables AI assistants to manage service desk operations via the Kaseya BMS API.Apache 2.0
- FlicenseAqualityCmaintenanceMCP server for Kaseya SaaS Alerts, providing 30 tools to manage security events, customers, users, devices, billing, and reports via the SaaS Alerts API.30-
- AlicenseNot gradedqualityCmaintenanceMCP server for MSP360 platform enabling management of backup and RMM operations through Claude Desktop with 69 tools.MIT