LWS
Manage LWS domains, DNS, hosting and account from an AI client; purchases off by default
- 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-mcpAdd 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)RequiredLWS_API_KEYLWS API key (LWS Panel > Api LWS)RequiredLWS_READ_ONLYtrue to expose only read toolsLWS_ENABLE_PURCHASEStrue to expose the paid tools (buy, renew)LWS_TEST_MODEtrue to use the LWS test environmentLWS_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.

