vsax-mcp-server

MCP (Model Context Protocol) server for VSAX (VSA 10) by Kaseya. Gives Claude (or any MCP client) full access to the VSAX REST API v3.

Quick Start

No installation needed — use npx directly in your MCP client config:

{
  "mcpServers": {
    "vsax": {
      "command": "npx",
      "args": ["-y", "vsax-mcp-server"],
      "env": {
        "VSAX_SERVER_NAME": "your-server.vsax.net",
        "VSAX_TOKEN_ID": "your-token-id",
        "VSAX_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

Or install globally:

npm install -g vsax-mcp-server

Getting Your API Token

Log into your VSAX instance
Navigate to Settings > API Tokens
Create a new token — you'll receive a Token ID and Token Secret
Note your server hostname (e.g., mycompany.vsax.net)

For full details, see the VSAX API documentation.

Configuration

The server requires three environment variables:

Variable	Description	Example
`VSAX_SERVER_NAME`	Your VSAX server hostname	`mycompany.vsax.net`
`VSAX_TOKEN_ID`	API token ID	`abc123`
`VSAX_TOKEN_SECRET`	API token secret	`secret456`

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vsax": {
      "command": "npx",
      "args": ["-y", "vsax-mcp-server"],
      "env": {
        "VSAX_SERVER_NAME": "your-server.vsax.net",
        "VSAX_TOKEN_ID": "your-token-id",
        "VSAX_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

Claude Code

Run:

claude mcp add vsax -e VSAX_SERVER_NAME=your-server.vsax.net -e VSAX_TOKEN_ID=your-token-id -e VSAX_TOKEN_SECRET=your-token-secret -- npx -y vsax-mcp-server

Install from Source

git clone https://github.com/your-org/vsax-mcp-server.git
cd vsax-mcp-server
npm install
npm run build

Then reference the local build in your MCP config:

{
  "mcpServers": {
    "vsax": {
      "command": "node",
      "args": ["/path/to/vsax-mcp-server/dist/index.js"],
      "env": {
        "VSAX_SERVER_NAME": "your-server.vsax.net",
        "VSAX_TOKEN_ID": "your-token-id",
        "VSAX_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

Features

67 tools covering every VSAX API v3 endpoint:

Category	Tools	Operations
Devices	8	publish, move, list, get, notifications, antivirus, custom fields, policies
Assets	2	list all, get by device
Workflows	5	run, executions, list, get
Tasks	7	run, execution status, devices, scripts, script output, list, get
Scripts	5	run, executions, list, get
Notifications	4	create, list, get, delete
Webhooks	6	create, update, regenerate secret, list, get, delete
Organizations	5	create, update, list, get, custom fields
Sites	5	create, update, list, get, custom fields
Groups	6	create, update, list, get, custom fields, package
Custom Fields	6	list, get, usage, assign, update, unassign
Scopes	3	list, get, usage
Patch Management	2	get policy, global rules
Endpoint Protection	1	get policy
Environment	1	get info
Audit Logs	1	get logs

Usage Examples

Once configured, you can ask Claude things like:

"List all devices in my VSAX instance"
"Show me the antivirus status for device X"
"Run workflow ABC on these 3 devices"
"What scripts have been executed recently?"
"Create a new organization called Acme Corp"
"Show me the audit logs filtered by user admin@company.com"

OData Query Support

All list endpoints support OData query parameters:

Parameter	Description	Example
`$top`	Number of records to return	`10`
`$skip`	Number of records to skip	`20`
`$filter`	OData filter expression	`Name eq 'Server01'`
`$orderby`	Sort expression	`Name asc`
`$count`	Include total count	`true`

Troubleshooting

Server won't start

Verify all three environment variables are set (VSAX_SERVER_NAME, VSAX_TOKEN_ID, VSAX_TOKEN_SECRET)
Check that Node.js 18+ is installed: node --version

Authentication errors (401)

Confirm your Token ID and Token Secret are correct
Ensure the API token has not expired in VSAX settings
Verify the server name matches your VSAX instance exactly (no https:// prefix, no trailing /)

Connection errors

Check that your VSAX instance is reachable from your machine
Ensure HTTPS (port 443) is not blocked by a firewall
Verify the server hostname resolves correctly: nslookup your-server.vsax.net

Empty or unexpected results

Try using $top=5 to limit results and verify the endpoint works
Check filter syntax matches OData conventions
Use vsax_get_environment to confirm API connectivity

API Reference

Full VSAX API documentation: https://api.vsax.net/#introduction

License

MIT

VSAX MCP Server