Swsd MCP Server

by mikimatsubio.github.mikimatsub/swsdv3.0.0

MCP server for SolarWinds Service Desk tickets, catalog, knowledge, ITSM operations, and workflows.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Swsd MCP server

claude mcp add swsd -e SWSD_TOKEN='<swsd-token>' -- npx -y swsd-mcp

{
  "mcpServers": {
    "swsd": {
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp"
      ],
      "env": {
        "SWSD_TOKEN": "<swsd-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "swsd": {
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp"
      ],
      "env": {
        "SWSD_TOKEN": "<swsd-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "swsd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp"
      ],
      "env": {
        "SWSD_TOKEN": "<swsd-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "swsd": {
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp"
      ],
      "env": {
        "SWSD_TOKEN": "<swsd-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
SWSD_TOKEN	yes	yes	SolarWinds Service Desk admin token (JWT). Generate in the SWSD UI: Setup -> Users & Groups -> Users -> [your user] -> Actions -> Generate JSON Web Token. Service Desk administrator rights required.
SWSD_BASE_URL	—	—	SWSD API base URL. US tenants: https://api.samanage.com (default). EU tenants: https://apieu.samanage.com.
SWSD_PROFILE	—	—	Tool registration profile: 'triage' (14 read-heavy tools), 'agent' (37 default), 'knowledge' (15 KB-author), 'operations' (64 ITSM operations tools), 'full' (66 every tool).
SWSD_WRITE_MODE	—	—	Write safety mode: 'live' calls SWSD normally; 'dry-run' returns write payload previews without sending writes; 'disabled' rejects write tools.
SWSD_ATTACHMENT_ROOT	—	—	Optional real-path boundary for local file_path attachment uploads over stdio. Files outside this directory are rejected.

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-10-04 · 5d ago · GitHub · v3.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-04 · 5d ago · official registry · v3.0.0

FAQ

›How do I install the Swsd MCP server in Claude Code?

Run: claude mcp add swsd -e SWSD_TOKEN='<swsd-token>' -- npx -y swsd-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Swsd require an API key?

Yes. It expects SWSD_TOKEN, of which 1 is a secret.

›Can I use Swsd as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Swsd in the official MCP registry?

Yes, as io.github.mikimatsub/swsd.