mcp-plesk-lite

mcp-plesk-lite

MCP server for Plesk web hosting administration. Manage domains, DNS, databases, mail, SSL certificates, backups, and WordPress installations via any MCP-compatible AI agent (Claude, n8n, etc.).

Self-hosted, lightweight.

Features

• 78+ tools covering the full Plesk REST API
• Works with Claude Desktop, n8n, Cursor, and any MCP client
• stdio transport (default) + HTTP Streamable transport (optional)
• Supports API key or username/password authentication
• Self-signed TLS certificate support
• Confirmation required for all destructive operations

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-plesk": {
      "command": "npx",
      "args": ["-y", "mcp-plesk-lite"],
      "env": {
        "PLESK_BASE_URL": "https://your-plesk-server.com:8443/api/v2",
        "PLESK_API_KEY": "your-api-key",
        "PLESK_ALLOW_SELF_SIGNED": "true"
      }
    }
  }
}

n8n (HTTP transport)

Start the server with an HTTP port:

PLESK_BASE_URL=https://your-plesk-server.com:8443/api/v2 \
PLESK_API_KEY=your-api-key \
MCP_HTTP_PORT=3000 \
npx mcp-plesk-lite

Then configure your n8n MCP node to connect to http://localhost:3000/mcp.

Manual install

npm install -g mcp-plesk-lite

Configuration

Copy .env.example to .env and fill in your values:

Variable	Required	Description
PLESK_BASE_URL	✅	Plesk API URL, e.g. https://your-server.com:8443/api/v2
PLESK_API_KEY	✅ *	API key — generate in Plesk → Profile → API Keys
PLESK_USERNAME	✅ *	Admin username (alternative to API key)
PLESK_PASSWORD	✅ *	Admin password (alternative to API key)
PLESK_ALLOW_SELF_SIGNED	❌	Accept self-signed TLS certs (default: true)
PLESK_DEFAULT_WP_SITE_ID	❌	Default WordPress site ID for wp_* tools (default: 5)
MCP_HTTP_PORT	❌	Run as HTTP server on this port instead of stdio

* Provide either PLESK_API_KEY or PLESK_USERNAME + PLESK_PASSWORD.

Available Tools

Server (3)

Tool	Description
plesk_server_info	Plesk version, hostname, OS, license, IP addresses
plesk_health_check	API availability and response latency
plesk_system_stats	CPU, RAM, disk, load average

Domains (6)

Tool	Description
plesk_list_domains	List all domains, optionally filtered by name
plesk_get_domain	Get domain details by ID
plesk_create_domain	Create a new domain ⚠️
plesk_update_domain	Update domain configuration
plesk_delete_domain	Delete domain and ALL data ⚠️
plesk_get_domain_status	Get domain operational status

Clients (7)

Tool	Description
plesk_list_clients	List all client accounts
plesk_get_client	Get client details and usage stats
plesk_create_client	Create a client account ⚠️
plesk_update_client	Update client account settings
plesk_delete_client	Delete client and ALL associated domains ⚠️
plesk_suspend_client	Suspend a client account ⚠️
plesk_activate_client	Reactivate a suspended client

Subscriptions (4)

Tool	Description
plesk_list_subscriptions	List all subscriptions
plesk_get_subscription	Get subscription details and status
plesk_suspend_subscription	Suspend a subscription ⚠️
plesk_enable_subscription	Reactivate a suspended subscription

DNS (4)

Tool	Description
plesk_get_dns_records	Get all DNS records for a domain
plesk_create_dns_record	Add a DNS record ⚠️
plesk_update_dns_record	Update a DNS record ⚠️
plesk_delete_dns_record	Delete a DNS record ⚠️

Databases (9)

Tool	Description
plesk_list_databases	List databases, optionally filtered by domain
plesk_get_database	Get database and its users
plesk_create_database	Create a database ⚠️
plesk_delete_database	Delete a database and ALL its data ⚠️
plesk_list_db_servers	List configured database servers
plesk_list_db_users	List database users
plesk_create_db_user	Create a database user ⚠️
plesk_update_db_user	Update database user password
plesk_delete_db_user	Delete a database user ⚠️

Mail (4)

Tool	Description
plesk_list_mailboxes	List mailboxes, optionally filtered by domain
plesk_create_mailbox	Create a mailbox ⚠️
plesk_delete_mailbox	Delete a mailbox and ALL emails ⚠️
plesk_reset_mailbox_password	Reset mailbox password ⚠️

SSL / TLS (3)

Tool	Description
plesk_list_certificates	List installed SSL certificates
plesk_install_certificate	Install SSL cert (manual PEM or Let's Encrypt) ⚠️
plesk_renew_certificate	Renew a Let's Encrypt certificate ⚠️

Backups (3)

Tool	Description
plesk_list_backups	List all backups
plesk_create_backup	Create server or domain backup ⚠️
plesk_restore_backup	Restore backup — IRREVERSIBLE ⚠️⚠️

WordPress (23)

Tool	Description
wp_list_sites	List all WP Toolkit managed installations
wp_get_site	Get WordPress site details
wp_get_site_status	Version, URL, security score, available updates
wp_security_status	Security status and vulnerabilities
wp_list_plugins	List plugins for a site
wp_list_themes	List themes for a site
wp_scan_installations	Scan server for all WP installations
wp_install_plugin	Install a plugin from WordPress.org ⚠️
wp_activate_plugin	Activate an installed plugin
wp_deactivate_plugin	Deactivate a plugin
wp_update_plugin	Update a plugin ⚠️
wp_remove_plugin	Remove a plugin ⚠️
wp_install_theme	Install a theme ⚠️
wp_activate_theme	Activate a theme
wp_update_theme	Update a theme ⚠️
wp_remove_theme	Remove a theme ⚠️
wp_update_core	Update WordPress core ⚠️⚠️
wp_apply_security_fix	Apply security hardening ⚠️
wp_clone_site	Clone a WP site to a new domain ⚠️⚠️
wp_sync_site	Sync WP site — overwrites target ⚠️⚠️
wp_enable_debug	Enable WP_DEBUG mode ⚠️
wp_disable_debug	Disable WP_DEBUG mode
wp_manage_maintenance_mode	Enable / disable maintenance mode ⚠️

Extensions (5)

Tool	Description
plesk_list_extensions	List installed extensions with version and status
plesk_get_extension	Get extension details by ID
plesk_install_extension	Install an extension from catalog, URL, or file ⚠️
plesk_remove_extension	Uninstall an extension ⚠️
plesk_toggle_extension	Enable or disable an extension

System / Advanced (7)

Tool	Description
plesk_raw_request	Execute any Plesk REST API request directly
plesk_list_cli_commands	List available Plesk CLI commands
plesk_get_cli_command_ref	Get CLI command options and subcommands
plesk_cli	Execute any Plesk CLI command
plesk_list_ftp_users	List FTP users
plesk_create_ftp_user	Create an FTP user ⚠️
plesk_delete_ftp_user	Delete an FTP user ⚠️

⚠️ = requires confirmation · ⚠️⚠️ = requires double confirmation (irreversible)

Contributing

Branch naming: fix/..., feat/..., chore/...

Commit messages follow Conventional Commits — semantic-release uses them to determine the next version automatically:

Prefix	Release
fix:	Patch 1.0.x
feat:	Minor 1.x.0
feat!: / BREAKING CHANGE	Major x.0.0
chore: / docs:	No release

See CONTRIBUTING for the full PR checklist.

License

MIT © Mohamed Ben Hariz