Swsd

MCP server · by mikimatsub

Developer Tools npm v3.4.0

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

View source ↗ Website ↗ Generate config for multiple servers More servers

Install

Pin version registry version 3.4.0

npm
npx -y swsd-mcp

npm
npx -y swsd-mcp@3.4.0

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

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

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

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add --env SWSD_TOKEN=<YOUR_SWSD_TOKEN> swsd -- npx -y swsd-mcp

claude mcp add --env SWSD_TOKEN=<YOUR_SWSD_TOKEN> swsd -- npx -y swsd-mcp@3.4.0

Format verified against the official Claude Code docs ↗.

.cursor/mcp.json

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

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

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

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

{
  "servers": {
    "swsd": {
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp@3.4.0"
      ],
      "env": {
        "SWSD_TOKEN": "<YOUR_SWSD_TOKEN>"
      }
    }
  }
}

Format verified against the official VS Code docs ↗.

mcp_config.json

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

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

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

SWSD_TOKEN required secret — 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' (22 read-heavy tools), 'agent' (52 default), 'knowledge' (17 KB-author), 'operations' (146 every tool), 'custom' (explicit SWSD_TOOLS and/or SWSD_PROFILE_FILE selection).
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.
SWSD_TOOLS — With SWSD_PROFILE=custom, comma-separated tool names (whitespace trimmed). Unioned with SWSD_PROFILE_FILE. Unknown names warn and are skipped; the resulting selection must be nonempty.
SWSD_PROFILE_FILE — With SWSD_PROFILE=custom, absolute or startup-cwd-relative path to a JSON profile (version 1). At most 256 KiB; unioned with SWSD_TOOLS. See schemas/swsd-profile.schema.json.
SWSD_MAX_ATTACHMENT_BYTES — Maximum downloaded attachment size in bytes (1–26214400); default 5 MiB. Applies to read-only attachment retrieval.

GitHub

⭐ 4 stars · 最近更新于 29 天前 · MIT license

About this server

swsd mcp MCP server for SolarWinds Service Desk (SWSD / Samanage). Works with any Model Context Protocol client to handle tickets, service requests, knowledge base work, change/release workflows, assets/CMDB context, procurement records, risks, time entries, and attachments using each user's own SWS…

Summary from the project README — github.com/mikimatsub/swsd-mcp

Distributed as npm, listed under Developer Tools. Review our MCP security guide before granting access to real data.

Frequently asked questions

What does the Swsd MCP server do?

How do I install Swsd?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Swsd free to use?

The MCP server itself is free to install. The source is public on https://github.com/mikimatsub/swsd-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Swsd?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/swsd.svg)](https://mcpnav.net/server/swsd/)

HTML

<a href="https://mcpnav.net/server/swsd/"><img src="https://mcpnav.net/badge/swsd.svg" alt="Listed on MCPNav" height="20"></a>