Skip to content

MCP Server for Webhosting4U Domain Registrar - Register, transfer and manage domain names from your IDE using AI and natural language. 32 tools, Cloudflare Workers, Streamable HTTP transport.

License

Notifications You must be signed in to change notification settings

Webhosting4U/Domain-Names-MCP-Server

Repository files navigation

Webhosting4U



DomainsReseller MCP Server

Register, transfer, and manage domain names from your IDE using natural language

Designed for the Webhosting4U domain registrar

Cloudflare Workers MCP Protocol TypeScript License: AGPL-3.0

A production-ready Model Context Protocol server for managing domain names -- registrations, transfers, renewals, DNS, nameservers, contacts, and more -- through 32 MCP tools accessible via natural language from any MCP-compatible IDE.

Provided by Webhosting4U

English | Ελληνικα


What Is This?

This is an MCP server built for the Webhosting4U domain registrar. It gives your AI coding assistant (in VS Code, or any other MCP-compatible IDE) the ability to manage domain names on your behalf through the Webhosting4U DomainsReseller API. Instead of logging into a web panel, you just type what you want in natural language:

"Is example.com available?"

"Register mydomain.io for 2 years"

"Show me the DNS records for mysite.gr"

The AI calls the right tool automatically. No manual API calls, no web forms -- just conversation.

What Is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants in IDEs connect to external tools and services. This server implements MCP so your IDE can talk to the domain registration API directly.


Highlights

  • 32 domain management tools -- register, transfer, renew, DNS, nameservers, contacts, WHOIS, and more
  • Natural language interface -- ask "Is example.com available?" and get an answer
  • Works with any MCP-compatible IDE -- VS Code, and any editor that supports Streamable HTTP MCP
  • Secure by design -- API keys encrypted at rest, session-based auth, rate limiting, zero data leakage
  • Globally distributed -- runs on Cloudflare's edge network for low latency worldwide

Prerequisites

To use this MCP server you need a Domain Reseller account and an API key from Webhosting4U.

  1. Create an account -- Order a Domain Reseller package. Orders are manually reviewed and activated.
  2. Get your API key -- Once your account is activated, generate an API key from your reseller control panel.
  3. Add credits -- Domain registrations, transfers, and renewals require available credits in your account. Top up your balance before placing orders.

Quick Start

Step 1 -- Connect Your IDE

Point your MCP client at the server endpoint:

https://mcp-domains.webhosting4u.gr/mcp

Transport: Streamable HTTP

VS Code (1.99+)
  1. Open VS Code Settings and enable chat.mcp.enabled
  2. Create a file called .vscode/mcp.json in your project root
  3. Paste the following configuration:
{
  "servers": {
    "domains-reseller": {
      "type": "http",
      "url": "https://mcp-domains.webhosting4u.gr/mcp"
    }
  }
}
  1. Restart VS Code

The "domains-reseller" server will now appear in your MCP servers list.

Other MCP Clients

Any client supporting Streamable HTTP transport can connect. Configure it with:

  • URL: https://mcp-domains.webhosting4u.gr/mcp
  • Transport: Streamable HTTP
  • Content-Type: application/json
  • Accept: application/json, text/event-stream

Step 2 -- Log In

Once your IDE is connected, open the AI chat and type:

Log me in to the domains reseller with email your@email.com and API key YOUR_API_KEY

Replace your@email.com with the email associated with your Webhosting4U reseller account, and YOUR_API_KEY with the API key from your control panel.

The server will:

  1. Validate your credentials against the upstream API
  2. Encrypt your API key and store it securely on the server
  3. Return a session token valid for 12 hours

After login, your API key is never sent again. All tool calls use the session token.

Step 3 -- Manage Domains

Just ask in plain language. The AI will pick the right tool automatically:

What you say What happens
"Is example.com available?" Checks domain availability
"Check DNS records for mydomain.gr" Gets DNS records
"What TLDs do you support?" Lists available TLDs
"How much does a .io domain cost?" Gets TLD pricing
"Register coolstartup.io for 2 years" Registers the domain (requires credits)
"Transfer mydomain.com with EPP code ABC123" Initiates domain transfer
"What's my account balance?" Shows available credits
"Log me out" Ends the session

Step 4 -- Log Out

When you're done, say:

Log me out

This revokes your session immediately.


Available Tools (32)

Authentication

Tool Description
auth_login Authenticate with email + API key, receive session token
auth_logout Revoke session token

Domain Availability

Tool Description
domains_lookup Check if a domain is available across one or more TLDs
domains_lookup_suggestions Get alternative domain name suggestions

Domain Management

Tool Description
domains_information_get Get detailed domain information (expiry, status, etc.)
domains_contact_get Get WHOIS contact details
domains_contact_save Update WHOIS contact details
domains_nameservers_get Get nameservers for a domain
domains_nameservers_save Update nameservers
domains_nameservers_register Register a child/glue nameserver
domains_nameservers_modify Change a child nameserver's IP
domains_nameservers_delete Delete a child nameserver
domains_dns_get Get DNS records
domains_dns_save Update DNS records
domains_lock_get Check registrar lock status
domains_lock_save Lock or unlock a domain
domains_eppcode_get Get EPP/auth code for domain transfer
domains_email_get Get email forwarding settings
domains_email_save Update email forwarding
domains_protectid_toggle Enable or disable WHOIS ID protection
domains_release Release domain to another registrar
domains_delete Request domain deletion
domains_sync Sync domain status with registry
domains_transfersync Sync transfer status

Orders & Pricing

Tool Description
order_domains_register Register a new domain (requires credits)
order_domains_transfer Transfer a domain to your account (requires credits)
order_domains_renew Renew an existing domain (requires credits)
order_pricing_domains_get Get pricing for registration, transfer, or renewal

Billing & System

Tool Description
billing_credits_get Check your account credit balance
system_version Get API version (useful as a health check)
tlds_list List all available TLDs
tlds_pricing_get Get pricing for all available TLDs

Architecture

+-------------------------+
|   IDE (MCP Client)      |
+------------+------------+
             |
             |  Streamable HTTP (MCP)
             v
+------------+------------+     +----------------------------+
|   Cloudflare Worker     +---->|  Workers KV                |
|                         |     |  (encrypted sessions)      |
|   - Auth + validation   |     +----------------------------+
|   - Tool routing        |
|   - Error handling      +---->+----------------------------+
|                         |     |  Durable Objects           |
+------------+------------+     |  (per-session rate limits) |
             |                  +----------------------------+
             |
             |  HTTPS + HMAC-SHA256    +----------------------------+
             +------------------------>|  D1 Database               |
             |                         |  (audit logs, no PII)      |
             v                         +----------------------------+
+------------+------------+
|  WHMCS DomainsReseller  |
|  API (upstream)         |
+-------------------------+
  • API keys encrypted at rest with AES-256-GCM
  • Per-session rate limiting via Durable Objects
  • PII-minimized audit logging
  • Fixed upstream URL (no SSRF possible)
  • Zod schema validation on every input

webhosting4u.gr

Built with Cloudflare Workers and MCP

AGPL-3.0 License

About

MCP Server for Webhosting4U Domain Registrar - Register, transfer and manage domain names from your IDE using AI and natural language. 32 tools, Cloudflare Workers, Streamable HTTP transport.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •