Skip to content
MCP server

LWS

Manage LWS domains, DNS, hosting and account from an AI client; purchases off by default

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About LWS

LWS is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • LWS_LOGINYour LWS account ID (the digits of LWS-XXXXXX)Required
  • LWS_API_KEYLWS API key (LWS Panel > Api LWS)Required
  • LWS_READ_ONLYtrue to expose only read tools
  • LWS_ENABLE_PURCHASEStrue to expose the paid tools (buy, renew)
  • LWS_TEST_MODEtrue to use the LWS test environment
  • LWS_TEST_API_KEYTest key, used instead of LWS_API_KEY in test mode

Tools this server provides (28)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licensed; requires an LWS account and API key

LWS 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.

How AIPoweredBot checks servers