Admtools

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