swsd — Claude Code MCP server: features and setup
swsd is an MCP server for Claude Code that connects an agent to SolarWinds Service Desk. It handles ticket, knowledge-base, and ITSM workflows.
MIT ★ 5 updated 2026-11-16
claude mcp add --env SWSD_TOKEN=<SWSD_TOKEN> --env SWSD_BASE_URL=<SWSD_BASE_URL> --env SWSD_PROFILE=<SWSD_PROFILE> --env SWSD_WRITE_MODE=<SWSD_WRITE_MODE> --env SWSD_ATTACHMENT_ROOT=<SWSD_ATTACHMENT_ROOT> --transport stdio swsd -- npx -y swsd-mcpWhat swsd does
swsd sends agent requests to SolarWinds Service Desk and returns information about tickets, service requests, knowledge articles, and assets. It also covers change and release workflows, procurement records, risks, time entries, and attachments.
The setup needs a SWSD JSON Web Token and an MCP client that supports stdio or Streamable HTTP. Local npm installation requires Node.js 24.15 or later in the 24 series, or Node.js 26 or later, plus npm. Node.js 25 is unsupported.
With stdio, the token stays in the server process for its lifetime; HTTP clients provide a token with each request. Claude Code can add the server with claude mcp add. The basic command sets SWSD_TOKEN; an extended configuration can also provide the base URL, profile, write mode, and attachment root.
What it helps with
- find a ticket in SolarWinds Service Desk
- retrieve a knowledge-base article
- handle a service request
- look up asset details and time entries
Example prompts for the agent
- Find the SolarWinds Service Desk ticket about a failed VPN connection.
- Search the knowledge base for access setup instructions.
- Show asset details and recent time entries.
How to install swsd
Platform CLI
claude mcp add --env SWSD_TOKEN=<SWSD_TOKEN> --env SWSD_BASE_URL=<SWSD_BASE_URL> --env SWSD_PROFILE=<SWSD_PROFILE> --env SWSD_WRITE_MODE=<SWSD_WRITE_MODE> --env SWSD_ATTACHMENT_ROOT=<SWSD_ATTACHMENT_ROOT> --transport stdio swsd -- npx -y swsd-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add swsd --env SWSD_TOKEN=<SWSD_TOKEN> --env SWSD_BASE_URL=<SWSD_BASE_URL> --env SWSD_PROFILE=<SWSD_PROFILE> --env SWSD_WRITE_MODE=<SWSD_WRITE_MODE> --env SWSD_ATTACHMENT_ROOT=<SWSD_ATTACHMENT_ROOT> -- npx -y swsd-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"swsd": {
"command": "npx",
"args": [
"-y",
"swsd-mcp"
],
"env": {
"SWSD_TOKEN": "<SWSD_TOKEN>",
"SWSD_BASE_URL": "<SWSD_BASE_URL>",
"SWSD_PROFILE": "<SWSD_PROFILE>",
"SWSD_WRITE_MODE": "<SWSD_WRITE_MODE>",
"SWSD_ATTACHMENT_ROOT": "<SWSD_ATTACHMENT_ROOT>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"swsd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"swsd-mcp"
],
"env": {
"SWSD_TOKEN": "<SWSD_TOKEN>",
"SWSD_BASE_URL": "<SWSD_BASE_URL>",
"SWSD_PROFILE": "<SWSD_PROFILE>",
"SWSD_WRITE_MODE": "<SWSD_WRITE_MODE>",
"SWSD_ATTACHMENT_ROOT": "<SWSD_ATTACHMENT_ROOT>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
gemini mcp add -e SWSD_TOKEN=<SWSD_TOKEN> -e SWSD_BASE_URL=<SWSD_BASE_URL> -e SWSD_PROFILE=<SWSD_PROFILE> -e SWSD_WRITE_MODE=<SWSD_WRITE_MODE> -e SWSD_ATTACHMENT_ROOT=<SWSD_ATTACHMENT_ROOT> swsd npx -y swsd-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about swsd
How do I install swsd in Claude Code?
Run claude mcp add swsd -e SWSD_TOKEN=<SWSD_TOKEN> -- npx -y swsd-mcp, replacing <SWSD_TOKEN> with a SWSD JSON Web Token. Local npm use requires Node.js and npm.
What does swsd do?
It connects an AI client to SolarWinds Service Desk for ticket, knowledge-base, asset, and other ITSM operations.
What does swsd need to run?
It needs a SWSD JSON Web Token and an MCP client supporting stdio or Streamable HTTP. Local npm installation also requires Node.js 24.15 or later in the 24 series, or Node.js 26 or later, and npm.