WEDOS WAPI MCP server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WEDOS WAPI MCP server
MCP server pro WEDOS WAPI. Umožňuje AI asistentům (Claude Desktop, Claude Code, Codex, ChatGPT…) spravovat domény, DNS záznamy a kredit u WEDOS – i napříč více účty.
Neoficiální projekt, není spojen se společností WEDOS Internet, a.s.
Co umí
Domény – výpis, detail, kontrola dostupnosti, registrace, prodloužení, transfer, změna nameserverů, odeslání auth-info
DNS – výpis zón a záznamů, přidání / úprava / smazání záznamu, commit zóny, přidání a smazání zóny
Kontakty a NSSET – detail, kontrola dostupnosti handle
Účet – stav kreditu, historie, POLL fronta notifikací
Více účtů – jedna instance serveru, účet se volí parametrem
accountOchrany – testovací režim, režim jen pro čtení (globálně i per účet), MCP anotace pro destruktivní akce
Fallback –
wapi_callzavolá libovolný WAPI příkaz, který nemá vlastní toolTransport – stdio (lokálně) i Streamable HTTP (vzdáleně, např. pro ChatGPT)
Related MCP server: WHMCS MCP Server
Požadavky
Node.js 18+
Účet u WEDOS s aktivovaným WAPI
1. Nastavení WAPI ve WEDOS
V klientské administraci WEDOS → Můj účet → Nastavení WAPI:
Zaškrtni Aktivovat WAPI.
Do Povolené IP adresy zadej veřejnou IP stroje, ze kterého server poběží (zjistíš přes
curl -4 ifconfig.me). Více IP odděl mezerou, IPv6 je podporováno.Způsob notifikací: nech POLL fronta.
Preferovaný protokol: JSON.
V sekci Nastavení hesla nastav WAPI heslo (je jiné než heslo k účtu).
Máš-li dynamickou IP (domácí připojení), whitelist po její změně přestane fungovat. Pro trvalý provoz je lepší server se statickou IP.
2. Instalace
git clone https://github.com/hrnicek/wedos-wapi-mcp.git
cd wedos-wapi-mcp
npm install # zároveň spustí build do dist/3. Konfigurace
Jeden účet
Stačí proměnné prostředí:
Proměnná | Povinná | Popis |
| ano | Login (e-mail) do WEDOS |
| ano | WAPI heslo |
| ne |
|
| ne |
|
| ne | výchozí |
| ne | výchozí |
Více účtů
Zkopíruj accounts.example.json na accounts.json (je v .gitignore) a uprav:
{
"default": "hlavni",
"accounts": {
"hlavni": { "label": "Hlavní účet", "login": "ucet@example.cz", "passwordEnv": "WEDOS_PW_HLAVNI" },
"klient": { "label": "Klient s.r.o.", "login": "admin@klient.cz", "passwordEnv": "WEDOS_PW_KLIENT", "readOnly": true }
}
}Klíč | Popis |
| účet použitý, když tool nedostane |
| login do WEDOS |
| název env proměnné s heslem (doporučeno – heslo pak není v souboru) |
| alternativně heslo přímo v souboru |
| zápisové tooly pro tento účet vrátí chybu |
| testovací režim jen pro tento účet |
Server pak spustíš s WEDOS_ACCOUNTS_FILE=/cesta/k/accounts.json a hesly v příslušných proměnných. Globální WEDOS_TEST_MODE a WEDOS_READ_ONLY platí pro všechny účty.
Povolenou IP je nutné nastavit u každého WEDOS účtu zvlášť.
4. Připojení do klienta
V příkladech nahraď /cesta/k/wedos-wapi-mcp skutečnou cestou.
Claude Desktop
Settings → Developer → Edit Config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"wedos": {
"command": "node",
"args": ["/cesta/k/wedos-wapi-mcp/dist/index.js"],
"env": {
"WEDOS_ACCOUNTS_FILE": "/cesta/k/wedos-wapi-mcp/accounts.json",
"WEDOS_PW_HLAVNI": "heslo",
"WEDOS_PW_KLIENT": "heslo"
}
}
}
}Poté Claude Desktop úplně ukonči (Cmd+Q) a spusť znovu.
Claude Code
claude mcp add wedos -s user \
-e WEDOS_LOGIN=ucet@example.cz \
-e WEDOS_WAPI_PASSWORD='heslo' \
-- node /cesta/k/wedos-wapi-mcp/dist/index.jsCodex
~/.codex/config.toml:
[mcp_servers.wedos]
command = "node"
args = ["/cesta/k/wedos-wapi-mcp/dist/index.js"]
[mcp_servers.wedos.env]
WEDOS_ACCOUNTS_FILE = "/cesta/k/wedos-wapi-mcp/accounts.json"
WEDOS_PW_HLAVNI = "heslo"
WEDOS_PW_KLIENT = "heslo"ChatGPT (vzdálený server přes HTTP)
ChatGPT neumí spouštět lokální procesy, potřebuje veřejnou HTTPS URL. Server spusť v HTTP režimu na serveru se statickou IP:
MCP_TRANSPORT=http PORT=3000 HOST=127.0.0.1 \
MCP_PATH_SECRET=$(openssl rand -hex 24) \
WEDOS_ACCOUNTS_FILE=/cesta/k/accounts.json WEDOS_PW_HLAVNI=heslo \
node dist/index.jsEndpoint:
POST /mcp/<MCP_PATH_SECRET>(Streamable HTTP, stateless), healthcheckGET /health.Před server dej reverzní proxy s HTTPS (Nginx, Caddy…) a proces spouštěj jako službu (systemd, supervisor, PM2).
V ChatGPT: Settings → Connectors → Developer mode → Create → URL
https://tvoje-domena.cz/mcp/<secret>, autentizace „No authentication“.
Bezpečnost: jedinou ochranou je tajný řetězec v URL. Kdo ho zná, má plný přístup k účtům včetně registrace domén za kredit. Vypni access log pro tuto cestu, používej
readOnlyvšude, kde nepotřebuješ zápis, a secret pravidelně měň.
5. Použití
Ověření spojení:
pingni wedos
Příklady promptů:
„Jaké mám WEDOS účty?“
„Vypiš domény, které expirují do konce roku.“
„Přidej A záznam
test.example.cz→1.2.3.4s TTL 300.“„Smaž TXT záznam pro
_acme-challengena example.cz na účtu klient.“„Kolik mám kreditu?“
Bez uvedení účtu se použije výchozí. Každá odpověď obsahuje pole account, takže je vidět, nad kterým účtem akce proběhla.
Přehled toolů
Tool | Typ | WAPI příkaz |
| čtení | – |
| čtení |
|
| čtení |
|
| čtení |
|
| čtení / zápis |
|
| čtení |
|
| čtení |
|
| čtení |
|
| čtení |
|
| zápis, účtuje kredit |
|
| zápis, účtuje kredit |
|
| zápis, účtuje kredit |
|
| destruktivní |
|
| zápis |
|
| čtení |
|
| čtení |
|
| čtení |
|
| čtení |
|
| čtení |
|
| čtení |
|
| zápis |
|
| destruktivní |
|
| zápis |
|
| destruktivní |
|
| destruktivní |
|
| zápis |
|
| destruktivní | libovolný |
DNS zápisové tooly po změně automaticky volají dns-domain-commit; vypneš parametrem commit: false (např. při dávce více změn).
Jak to funguje
Požadavek jde jako
POSTnahttps://api.wedos.com/wapi/jsons polemrequestobsahujícím JSON.Autentizace:
auth = sha1(login + sha1(wapi_heslo) + HH), kdeHHje aktuální hodina v časové zóněEurope/Prague.Kódy
1000= OK,1001= přijato asynchronně (výsledek přijde do POLL fronty),>= 2000= chyba – tool vrátíisErrori s plnou odpovědí.
Řešení problémů
Problém | Příčina / řešení |
Chyba autentizace | IP není ve whitelistu, špatné WAPI heslo, nebo požadavek padl přesně na přelom hodiny – zopakuj |
| Síťová chyba nebo blokace IP po překročení rate limitu – počkej a zkus znovu |
| Účet má v |
Klient tooly nevidí | Zkontroluj cestu k |
Nesedí parametry příkazu | Ověř v dokumentaci WAPI a případně použij |
Vývoj
npm run dev # tsc --watch
npm run buildStruktura:
src/wapi.ts– HTTP klient pro WAPI (autentizace, chyby, timeout)src/accounts.ts– načítání účtů z env /accounts.jsonsrc/index.ts– registrace MCP toolů, stdio a HTTP transport
Licence
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Register, transfer and manage domain names and DNS from your AI agent.
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
Connect custom domains via AI agents: DNS pre-flight checks, hand-off connect sessions and checks.
Buy & manage domains from any AI chat: availability, register, DNS, email forwarding, AI bot stats.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables agentic administration of Infomaniak accounts via Claude, offering 169 tools for web hosting, mail, domains, DNS, and more, with a strict two-phase commit for safe mutations.1003 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to administrate WHMCS installations through the External API, providing ~50 tools for clients, billing, orders, services, domains, support, and aggregators with safety features and governance.3ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Namecheap domains, DNS, contacts, registrar locks, and view SSL certificates and pricing through safe read and configuration tools.1652 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to query and manage a web hosting billing platform through its External API — clients, tickets, invoices, domains, orders, products, and system data. It defaults to read-only with per-domain opt-in for writes, two-step confirmation for billing and destructive actions, and automatic redaction of secrets, card data, and PII.1MIT