Mokonyx MCP Server

Details
Category: Mokonyx MCP
  • Applicable Software: Mokonyx MCP

What It Does

mcp-mokonyx lets AI assistants like Claude manage Mokonyx sites through the MokonyxClient Joomla Web Services API. Every named connection is a Mokonyx site (or the HQ control plane), and all tools accept an optional connection parameter for multi-site management.

Credential Tiers

  • Read / CRUD — a Joomla Web Services Bearer token (apiToken) for reads and content actions.
  • Remote control (RSA-signed) — an optional site health_api_token plus HQ's RSA-2048 signing key, required only for provisioning, remote login, and mass user operations.

Destructive fleet-wide operations require an explicit confirm: true.

Tool Tiers (24 tools)

mokonyx_ping, list_connections, and api_request (raw Joomla v1 endpoint access).

client_get_health, client_get_dashboard, client_list_extensions, client_list_plugins, client_list_snapshots, client_list_users, client_export_users.

client_clear_cache, client_check_updates, client_install_extension, client_toggle_plugin, client_create_snapshot, client_reset_snapshot, client_sync_push.

client_provision_reset, client_remote_login, client_users_reset_passwords, client_users_reset_2fa, client_users_disable_all, client_users_enable_all, client_users_force_logout.

Install

npm install -g @mokoconsulting/mcp-mokonyx

Or run on demand with npx:

npx @mokoconsulting/mcp-mokonyx

Configuration

Create ~/.mcp_mokonyx.json (or point MOKONYX_CONFIG at a file):

{
  "defaultConnection": "moko-live",
  "connections": {
    "moko-live": {
      "baseUrl": "https://mokoconsulting.tech",
      "apiToken": "your-joomla-api-token"
    }
  }
}

apiToken is a Joomla Web Services API token (Users → Manage → API Tokens). Add healthApiToken, rsaPrivateKeyPath, and keyVersion only for the remote-control tools.

Claude Code Registration

{
  "mcpServers": {
    "mokonyx": {
      "command": "npx",
      "args": ["-y", "@mokoconsulting/mcp-mokonyx"]
    }
  }
}

Source & License

Open source under GPL-3.0-or-later. Repository: MokoConsulting/mcp-mokonyx

Hits: 140