Dreamscape MCP Server

MCP server for the Dreamscape Reseller REST API (Dreamscape Networks / Crazy Domains), focused on domain registry operations: domains, availability and TLD pricing, transfers, registrant contacts, glue records (hosts), and customers.

Configuration

Set via environment variables (or a .env file — see .env.example):

| Variable | Default | Description | |---|---|---| | DREAMSCAPE_API_KEY | (required) | API key from Reseller Console → Account Settings → API & WHMCS → API Setup | | DREAMSCAPE_READONLY | true | When true, write tools (register/renew/transfer/update/delete) are not registered | | DREAMSCAPE_DNS_ENABLED | false | When true, registers Dreamscape DNS record tools. Off by default — customer DNS is managed in DNS Made Easy | | DREAMSCAPE_SANDBOX | false | When true, targets reseller-api.sandbox.ds.network instead of production |

Tools

Always registered (read-only, 15): check_connection, get_balance, list_invoices, list_currencies, list_tlds, check_availability, list_domains, get_domain, check_transfer_availability, list_registrants, get_registrant, list_hosts, get_host, list_customers, get_customer

With DREAMSCAPE_READONLY=false (+15): register_domain, update_domain, renew_domain, delete_domain, request_transfer, cancel_transfer, create_registrant, update_registrant, add_host, update_host, delete_host, create_customer, update_customer, delete_customer, create_customer_login_link

With DREAMSCAPE_DNS_ENABLED=true (+2 read; +3 more write when not readonly): list_dns_records, get_dns_record, create_dns_record, update_dns_record, delete_dns_record

Note: register_domain, renew_domain, and request_transfer spend reseller account balance.

Authentication

Each request sends a unique Api-Request-Id (MD5 of a random UUID) and an Api-Signature of MD5(request_id + api_key), per the Dreamscape auth scheme.

Usage

// Claude Code / MCP client config
{
  "mcpServers": {
    "dreamscape": {
      "command": "node",
      "args": ["C:/Users/daryl/Development/Dreamscape-MCP/dist/index.js"],
      "env": {
        "DREAMSCAPE_API_KEY": "...",
        "DREAMSCAPE_READONLY": "true"
      }
    }
  }
}

Development

npm install
npm run dev        # tsx watch
npm run typecheck
npm run build

The full OpenAPI spec the tools were built from is saved at reference/dreamscape-openapi.json (fetched from https://doc-reseller-api.ds.network/schema/json).