Swsd MCP 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 SWSD API token. See the client compatibility matrix for the tested list.

📖 Full docs: mcp-swsd.pages.dev

The server holds zero credentials at rest. Tokens are forwarded per-request, never persisted, never logged, and only sent to the configured SWSD API host.

Quick start

You need:

• An MCP client installed: any MCP-compatible client works (compatibility matrix)
• A SolarWinds Service Desk admin token (JWT): generate one in the SWSD UI: Setup → Users & Groups → Users → click your user → Actions → Generate JSON Web Token (Service Desk administrator rights required)

VS Code

1. Open the Command Palette: Ctrl+Shift+P on Windows/Linux or Shift+Command+P on macOS.
2. Run MCP: Add Server....

1. Install with either supported local option:

• Command (stdio): enter npx -y swsd-mcp.
• NPM Package: enter swsd-mcp, confirm that the publisher is mikimatsub, then select Allow.

1. Name the server swsd, then choose Global for your VS Code profile or Workspace for the current project.
2. Add the SWSD token securely and verify the connection.

Other stdio clients

1. Add the config

The non-VS-Code clients listed below use this common JSON shape. Add it under mcpServers in your client's config file:

{
  "mcpServers": {
    "swsd": {
      "command": "npx",
      "args": ["-y", "swsd-mcp"],
      "env": {
        "SWSD_TOKEN": "your-jwt-here",
        "SWSD_BASE_URL": "https://api.samanage.com"
      }
    }
  }
}

Replace your-jwt-here with your token. EU tenants use https://apieu.samanage.com instead. To customize behavior, add any configuration variable (most common: SWSD_PROFILE to choose the tool set) into the same env block.

2. Drop it in the right file

Create the file if it doesn't exist. Then restart your client.

Shortened. The full README is on GitHub.