# LWS

> LWS is an open-source MCP server for cloud and infrastructure. Manage LWS domains, DNS, hosting and account from an AI client; purchases off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/nkstud/lws-mcp
- **MCP Registry name:** io.github.NKSTUD/lws-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

A DNS-capable assistant can break a site or a mailbox, and one that can buy things can spend money, so this server is built around brakes. Purchases are off unless LWS_ENABLE_PURCHASES is set, read-only mode strips every tool that changes anything, each tool declares whether it reads, writes or destroys so clients can ask first, and a test mode points requests at the LWS sandbox. The API key goes only to api.lws.net and is never returned to the model.

It covers the whole LWS Client API with 29 endpoints. DNS tools add, update and delete records; domain tools check availability, list TLDs, change nameservers, set transfer protection, request auth codes and manage redirects; hosting tools list plans, prices and renewals and set auto-renew; account tools show balance, purchases and contacts. check_dns_propagation compares the LWS zone, the domain's nameservers and three public resolvers over HTTPS and estimates how long a stale answer can last.

You need an LWS account, an API key and your machine's public IP allowed in the LWS panel. LWS rate limits bursts of about fifteen calls. It is a community project, not affiliated with LWS, and MIT licensed.

## Features

- **DNS record management:** Add, update and delete records, with names normalised to the zone.
- **Propagation check:** Compares zone, nameservers and public resolvers over HTTPS.
- **Domain controls:** Availability, nameservers, transfer lock and auth codes.
- **Hosting info:** List plans, prices and renewals and set auto-renew.
- **Safety switches:** Read-only mode, purchases off by default and a test environment.
- **Tool annotations:** Each tool declares if it reads, writes or destroys.

## Good for

- Add the CNAME records a service gave you and confirm when they are live
- Check whether a domain name is available
- Review hosting renewals and prices
- Lock a domain against transfers

## Install

### Claude Code (Terminal)

```sh
claude mcp add lws-mcp --env LWS_LOGIN='<LWS_LOGIN>' --env LWS_API_KEY='<LWS_API_KEY>' --env LWS_TEST_API_KEY='<LWS_TEST_API_KEY>' -- uvx lws-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lws-mcp": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "<LWS_LOGIN>",
        "LWS_API_KEY": "<LWS_API_KEY>",
        "LWS_TEST_API_KEY": "<LWS_TEST_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lws-mcp": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "<LWS_LOGIN>",
        "LWS_API_KEY": "<LWS_API_KEY>",
        "LWS_TEST_API_KEY": "<LWS_TEST_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lws-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "<LWS_LOGIN>",
        "LWS_API_KEY": "<LWS_API_KEY>",
        "LWS_TEST_API_KEY": "<LWS_TEST_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lws-mcp": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "<LWS_LOGIN>",
        "LWS_API_KEY": "<LWS_API_KEY>",
        "LWS_TEST_API_KEY": "<LWS_TEST_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lws-mcp": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "<LWS_LOGIN>",
        "LWS_API_KEY": "<LWS_API_KEY>",
        "LWS_TEST_API_KEY": "<LWS_TEST_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_dns_zone`: Returns a DNS zone.
- `add_dns_record`: Adds a DNS record.
- `update_dns_record`: Updates a DNS record.
- `delete_dns_record`: Deletes a DNS record.
- `check_dns_propagation`: Compares the LWS zone with nameservers and public resolvers.
- `get_domain`: Returns a domain.
- `check_domain_availability`: Checks whether a domain is available.
- `list_tlds`: Lists available TLDs.
- `update_nameservers`: Changes nameservers.
- `set_transfer_protection`: Sets transfer protection.
- `request_transfer_authcode`: Requests a transfer auth code.
- `create_domain_redirect`: Creates a domain redirect.
- `delete_domain_redirect`: Deletes a domain redirect.
- `list_hostings`: Lists hostings.
- `get_hosting`: Returns a hosting.
- `list_hosting_prices`: Lists hosting prices.
- `get_renewal_prices`: Returns renewal prices.
- `set_auto_renew`: Sets auto-renew.
- `buy_hosting`: Buys hosting; off unless purchases are enabled.
- `renew_hosting`: Renews hosting; off unless purchases are enabled.
- `get_account_balance`: Returns the account balance.
- `get_purchase_history`: Returns purchase history.
- `list_contacts`: Lists contacts.
- `get_contact`: Returns a contact.
- `create_contact`: Creates a contact.
- `update_contact`: Updates a contact.
- `list_requests`: Lists requests.
- `list_pending_requests`: Lists pending background requests.

## FAQ

### Can it spend money?

Only if you set LWS_ENABLE_PURCHASES to true, which exposes buy_hosting and renew_hosting.

### Can I make it read-only?

Yes, set LWS_READ_ONLY to true.

### Why does every call fail with bad source?

The machine's public IP must be allowed on the Api LWS page of the LWS panel.

### Is it official?

No. It is a community project not affiliated with or endorsed by LWS.

### Is LWS free?

Yes. LWS is open source, so you can use and self-host it for free.

### How do I add LWS to Claude Code?

Run this command in your terminal: claude mcp add lws-mcp --env LWS_LOGIN='<LWS_LOGIN>' --env LWS_API_KEY='<LWS_API_KEY>' --env LWS_TEST_API_KEY='<LWS_TEST_API_KEY>' -- uvx lws-mcp

### What are the best alternatives to LWS?

The closest alternatives to LWS are mcp, Webflow, Ripe Stat, Vercel MCP and OpenWrt MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [Webflow](https://ai-powered.com/mcp/webflow): Webflow is a freemium MCP server for cloud and infrastructure.
- [Ripe Stat](https://ai-powered.com/mcp/ripe-stat): Ripe Stat is a freemium MCP server for cloud and infrastructure.
- [Vercel MCP](https://ai-powered.com/mcp/vercel-mcp): Vercel MCP is an MCP server for cloud and infrastructure.
- [OpenWrt MCP](https://ai-powered.com/mcp/openwrt-mcp): OpenWrt MCP is an open-source MCP server for cloud and infrastructure.
- [Opendatasoft](https://ai-powered.com/mcp/opendatasoft): Opendatasoft is a freemium MCP server for cloud and infrastructure.
- [Nist Beacon](https://ai-powered.com/mcp/nist-beacon): Nist Beacon is a freemium MCP server for cloud and infrastructure.
- [Gateway SSH](https://ai-powered.com/mcp/gateway-ssh): Gateway SSH is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/lws
