adm.tools (service from hosting.xyz / ukraine.com.ua) MCP Server

MCP server for adm.tools — the management panel behind ukraine.com.ua and hosting.xyz hosting platforms. Manage domains, DNS records, email, and billing from any MCP-compatible client.

12 tools for the adm.tools API, plus adm_api_raw when ADM_ALLOW_RAW=true.

Requirements

• Node.js 22+

• adm.tools API token (activate at adm.tools/user/api)

Related MCP server: realtime-register-mcp

Installation

git clone https://github.com/hlebtkachenko/admtools-mcp.git
cd admtools-mcp
npm ci
npm run build

Configuration

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "admtools": {
      "command": "node",
      "args": ["/path/to/admtools-mcp/dist/index.js"],
      "env": {
        "ADMTOOLS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json (location)

{
  "mcpServers": {
    "admtools": {
      "command": "node",
      "args": ["/path/to/admtools-mcp/dist/index.js"],
      "env": {
        "ADMTOOLS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code

.mcp.json in your project root, or ~/.claude.json globally:

{
  "mcpServers": {
    "admtools": {
      "command": "node",
      "args": ["/path/to/admtools-mcp/dist/index.js"],
      "env": {
        "ADMTOOLS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Any MCP client (stdio)

The server uses stdio transport. Point your MCP client to:

node /path/to/admtools-mcp/dist/index.js

With the ADMTOOLS_API_TOKEN environment variable set.

Environment Variables

Tools

Domains

DNS

Email

Billing

Raw API

The mail/* endpoints are not in the official client, so their parameter names (mail_id, mail_box_id) are unverified.

Security

• 30-second timeout on all HTTP requests; no automatic retries. A write that gets no response is reported as "outcome unknown" with the read tool to check

• Any response with result false or missing is returned as an error (except adm_domain_check, where false means "not available")

• Action paths must be /-separated segments of letters, digits, _ and -; .., query strings and empty paths are rejected

• adm_api_raw is off unless ADM_ALLOW_RAW=true; its params must be a JSON object

• Tool arguments are validated with Zod schemas; adm_api_raw params are free-form

Architecture

src/
  index.ts          Entry point, env validation
  adm-client.ts     API client (Bearer auth, form-encoded POST, result check)
  tools/
    domains.ts      Domain management (5 tools)
    dns.ts          DNS records (3 tools)
    mail.ts         Email management (3 tools)
    billing.ts      Balance, plus raw API when enabled (1-2 tools)
test/               node:test suite against a fake adm.tools API

Tech Stack

• TypeScript

• @modelcontextprotocol/sdk

• Zod (schema validation)

• Native fetch

What is adm.tools?

adm.tools is the hosting management panel used by Ukrainian hosting providers ukraine.com.ua and hosting.xyz. It provides a unified API for domain registration, DNS management, email, and billing across both platforms.

API Reference

• adm.tools API (requires login)

• Official PHP client

• Wiki

License

MIT