serverscom-mcp

MCP (Model Context Protocol) server for managing Servers.com dedicated server infrastructure. Enables AI assistants (Claude, etc.) to interact with the Servers.com API directly — query servers, manage SSH keys, configure networks, manage L2 segments, provision Remote Block Storage, reinstall operating systems, and more.

Quick Start

npx @servers.com/mcp --token your-api-token

# or via env var
SC_TOKEN=your-api-token npx @servers.com/mcp

Usage with Claude Desktop

{
  "mcpServers": {
    "serverscom": {
      "command": "npx",
      "args": ["-y", "@servers.com/mcp"],
      "env": {
        "SC_TOKEN": "your-api-token"
      }
    }
  }
}

Configuration

| Flag | Env var | Required | Default | Description | |---|---|---|---|---| | --token, -t | SC_TOKEN | yes | — | Servers.com API token | | --endpoint, -e | SC_ENDPOINT | no | https://api.servers.com/v1 | Custom API endpoint |

Available Tools

73 tools across 6 categories — see TOOLS.md for the full reference.

Async Operations

Many operations are asynchronous. After calling them, poll the relevant status field:

| Operation | Poll with | Field to watch | |---|---|---| | Feature changes | list_dedicated_server_features | feature status | | Rescue mode | get_dedicated_server | operational_status | | OS reinstallation | get_dedicated_server | operational_status | | Power changes | get_dedicated_server | power_status |

operational_status values: normal → provisioning → installation → entering_rescue_mode → rescue_mode → exiting_rescue_mode → maintenance

License

MIT

Development

Building from source

go build -o serverscom-mcp .

Releasing

Releases are automated via GoReleaser and GitHub Actions. Push a version tag to trigger the pipeline:

git tag v1.2.3
git push origin v1.2.3

The workflow will:

1. Build binaries for Linux, macOS, Windows (amd64 + arm64)
2. Create a GitHub Release with archives and checksums
3. Publish @servers.com/mcp and platform packages to npm using trusted publishing (OIDC, no long-lived tokens)

Project Structure

serverscom-mcp/
├── main.go                       # Entry point
└── internal/tools/
    ├── tools.go                  # Tool registration hub, shared helpers
    ├── hosts.go                  # list_hosts
    ├── dedicated_servers.go      # Server CRUD and feature management
    ├── ssh_keys.go               # SSH key operations
    ├── locations.go              # Location and infrastructure options
    ├── power.go                  # Power management
    ├── drives.go                 # Drive slot listing
    ├── reinstall.go              # OS reinstallation
    ├── networks.go               # Network management
    ├── l2_segments.go            # L2 segment management
    └── rbs.go                    # Remote Block Storage