# swsd

swsd is an MCP server for Claude Code that connects an agent to SolarWinds Service Desk. It handles ticket, knowledge-base, and ITSM workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: mikimatsub
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mikimatsub/swsd-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/swsd

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SWSD_TOKEN`, `SWSD_BASE_URL`, `SWSD_PROFILE`, `SWSD_WRITE_MODE`, `SWSD_ATTACHMENT_ROOT`, `SWSD_TOOLS`, `SWSD_PROFILE_FILE`, `SWSD_MAX_ATTACHMENT_BYTES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- 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
- 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.

## Similar
- [solarwinds-service-desk](https://affpapa.org/en/nevibecode/skills/solarwinds-service-desk.md) — skill · 182 installs
- [freshservice-automation](https://affpapa.org/en/nevibecode/skills/freshservice-automation.md) — skill · 121 installs
- [analyzing-supply-chain-malware-artifacts](https://affpapa.org/en/nevibecode/skills/analyzing-supply-chain-malware-artifacts.md) — skill · 293 installs
- [service-itsm-teams-employee-agent-configure](https://affpapa.org/en/nevibecode/skills/service-itsm-teams-employee-agent-configure.md) — skill · 1200 installs
- [service-itsm-agentic-setup-uel-user-create](https://affpapa.org/en/nevibecode/skills/service-itsm-agentic-setup-uel-user-create.md) — skill · 1200 installs
- [ServiceNow](https://affpapa.org/en/nevibecode/mcp/servicenow.md) — MCP server · ★ 14 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
