What It Does
mcp-mokosuite lets AI assistants like Claude manage MokoSuite sites through the MokoSuiteClient Joomla Web Services API. Every named connection is a MokoSuite 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_tokenplus 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)
mokosuite_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-mokosuite
Or run on demand with npx:
npx @mokoconsulting/mcp-mokosuite
Configuration
Create ~/.mcp_mokosuite.json (or point MOKOSUITE_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": {
"mokosuite": {
"command": "npx",
"args": ["-y", "@mokoconsulting/mcp-mokosuite"]
}
}
}
Source & License
Open source under GPL-3.0-or-later. Repository: MokoConsulting/mcp-mokosuite