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.

13 tools for the adm.tools API.

Requirements

• Node.js 20+
• adm.tools API token (activate at adm.tools/user/api)

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

| Variable | Required | Description | |----------|----------|-------------| | ADMTOOLS_API_TOKEN | Yes | Bearer token from adm.tools API settings |

Tools

Domains

| Tool | Description | |------|-------------| | adm_domains | List all domains with status and expiry | | adm_domain_check | Check domain availability for registration | | adm_domain_zones | Available zones with registration prices | | adm_domain_add | Add domain to NS servers for DNS management | | adm_get_id | Get object ID by type and name |

DNS

| Tool | Description | |------|-------------| | adm_dns_records | List DNS records for a domain | | adm_dns_add | Add record (A, AAAA, ALIAS, CAA, CNAME, MX, NS, TXT, SRV) | | adm_dns_delete | Delete a DNS record |

Email

| Tool | Description | |------|-------------| | adm_mail_domains | List all mail domains | | adm_mailboxes | List mailboxes and redirects for a domain | | adm_mailbox_delete | Delete a mailbox |

Billing

| Tool | Description | |------|-------------| | adm_balance | Current account balance (UAH) |

Raw API

| Tool | Description | |------|-------------| | adm_api_raw | Call any adm.tools API endpoint directly |

Security

• 30-second timeout on all HTTP requests
• API action path sanitized (leading/trailing slashes stripped)
• JSON parameters parsed in try/catch
• Error responses truncated to 500 characters
• All parameters validated with Zod schemas

Architecture

src/
  index.ts          Entry point, env validation
  adm-client.ts     API client (Bearer token, form-encoded POST)
  tools/
    domains.ts      Domain management (5 tools)
    dns.ts          DNS records (3 tools)
    mail.ts         Email management (3 tools)
    billing.ts      Balance and raw API (2 tools)

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