ispconfig-mcp

MCP (Model Context Protocol) server for ISPConfig 3 — manage DNS zones, mail domains, websites, databases, FTP users, cron jobs, and more through AI assistants like Claude.

Features

• DNS Management — zones, A/AAAA/CNAME/MX/NS/TXT/SRV/PTR records

• Mail Management — domains, mailboxes, aliases, forwards, catchall, spamfilter

• Site Management — web domains, subdomains, alias domains

• Database Management — create/delete MySQL databases

• FTP & Shell Users — create and manage access accounts

• Cron Jobs — schedule and manage cron tasks

• Client Management — create/update/delete ISPConfig clients

• Server Info — query server details by ID or IP

• Generic API Call — escape hatch for any of the ~246 ISPConfig API methods

• Server Migration — export/import DNS zones, mail domains, websites, databases between ISPConfig instances

Related MCP server: ItchWHMMCP

Prerequisites

• Node.js 18+

• An ISPConfig 3 installation with the Remote API enabled

• API user credentials (ISPConfig → System → Remote Users)

Installation

# Via npx (no install needed)
npx ispconfig-mcp

# Or install globally
npm install -g ispconfig-mcp

Configuration

Claude Code

claude mcp add ispconfig -- npx ispconfig-mcp

Then set environment variables in your shell or .env:

export ISPCONFIG_URL="https://your-server:8080"
export ISPCONFIG_USER="api_user"
export ISPCONFIG_PASSWORD="your_password"
# Optional: skip TLS verification for self-signed certs
export ISPCONFIG_INSECURE="true"

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "mcpServers": {
    "ispconfig": {
      "command": "npx",
      "args": ["-y", "ispconfig-mcp"],
      "env": {
        "ISPCONFIG_URL": "https://your-server:8080",
        "ISPCONFIG_USER": "api_user",
        "ISPCONFIG_PASSWORD": "your_password",
        "ISPCONFIG_INSECURE": "true"
      }
    }
  }
}

ISPConfig Setup

1. Log into ISPConfig panel → System → Remote Users

2. Create a new remote user with API access

3. Select the functions you want to allow (or grant all)

4. Use these credentials as ISPCONFIG_USER / ISPCONFIG_PASSWORD

Available Tools

DNS

Mail

Sites & Hosting

Admin

Migration

Migration Between Servers

The MCP supports migrating accounts between ISPConfig instances. The workflow:

1. Plan — migrate_plan inventories everything on the source

2. Export — migrate_export_* dumps config as portable JSON bundles

3. Import — migrate_import_* recreates config on the destination

4. Data — migrate_data_commands generates rsync/mysqldump commands for actual files/mail/databases

Migration Config

For direct source→destination migration, configure both instances:

{
  "mcpServers": {
    "ispconfig": {
      "command": "npx",
      "args": ["-y", "ispconfig-mcp"],
      "env": {
        "ISPCONFIG_URL": "https://old-server:8080",
        "ISPCONFIG_USER": "api_user",
        "ISPCONFIG_PASSWORD": "password",
        "ISPCONFIG_DEST_URL": "https://new-server:8080",
        "ISPCONFIG_DEST_USER": "api_user",
        "ISPCONFIG_DEST_PASSWORD": "password",
        "ISPCONFIG_INSECURE": "true"
      }
    }
  }
}

Without ISPCONFIG_DEST_URL, export tools still work — you can save the JSON and import later.

What gets migrated (config)

• DNS zones + all record types

• Mail domains + mailboxes + aliases + forwards + catchall

• Web domains + subdomains + alias domains

• FTP and shell users

• Database definitions

• Cron jobs

• Client accounts

What needs manual transfer (data)

The ISPConfig API manages configuration, not file data. These must be transferred separately:

• Mail spools — rsync /var/vmail/domain/

• Website files — rsync /var/www/domain/

• Database content — mysqldump / pg_dump

The migrate_data_commands tool generates the exact commands needed.

Example Prompts

Once connected, you can ask your AI assistant things like:

• "List all DNS zones on my server"

• "Add an A record for app.example.com pointing to 1.2.3.4"

• "Create a mailbox info@example.com with 1GB quota"

• "Add a mail forward from sales@example.com to team@example.com"

• "Show me all websites and their domains"

• "Create a cron job that runs /usr/local/bin/backup.sh every night at 2am"

• "Find all zones missing SPF records"

• "Export everything from the old server and show me a migration plan"

• "Migrate the DNS zone for example.com to the new server"

• "What rsync commands do I need to transfer mail data for example.com?"

Development

git clone https://github.com/DayZAnder/ispconfig-mcp.git
cd ispconfig-mcp
npm install
npm run build

License

BSD 3-Clause — same license as ISPConfig 3.