I've published v0.2.0 of the Cloudron MCP server on npm. This release includes 15 tools from Phase 1, but 8 of them I couldn't fully test.
Confirmed Working (7 tools)
Listing & Read Operations:
cloudron_list_apps - List all apps
cloudron_get_app - Get app details
cloudron_get_status - Get Cloudron status
cloudron_list_backups - List backups
cloudron_list_users - List users
cloudron_search_apps - Search App Store
System Operations:
cloudron_check_storage - Check disk space
These work reliably and return proper JSON results.
️ Needs Testing (8 tools)
Async Operations (return task IDs, need manual verification):
cloudron_task_status - Monitor async task progress
cloudron_cancel_task - Cancel running tasks
cloudron_control_app - Start/stop/restart apps
cloudron_create_backup - Create new backup (returns task ID)
cloudron_uninstall_app - Uninstall app (returns task ID)
Validation & Configuration:
cloudron_validate_operation - Pre-flight safety checks
cloudron_validate_manifest - App manifest validation
cloudron_configure_app - App configuration changes
Known Issues
cloudron_validate_manifest:
️ Currently returns mock validation only
Critical Bugs Fixed
cloudron_search_apps:
Fixed: Was returning empty results due to incomplete pagination handling
- Now properly aggregates results across all pages
F04 (cloudron_uninstall_app):
Fixed: Pre-flight validation check was incorrect
- Now properly validates with
cloudron_validate_operation before uninstall
Installation
npm install -g @serenichron/mcp-cloudron
Add to your MCP client of choice:
{
"mcpServers": {
"cloudron": {
"command": "npx",
"args": ["-y", "@serenichron/mcp-cloudron"],
"env": {
"CLOUDRON_HOST": "your-cloudron.example.com",
"CLOUDRON_TOKEN": "your-api-token"
}
}
}
}
Get your API token: https://your-cloudron.example.com/settings.html#account
Can You Help Test?
If you have a Cloudron instance and want to help validate these tools:
- Async operations: Test task status monitoring with actual app operations
- Backups: Verify backup creation works end-to-end
- App control: Test start/stop/restart operations
- Validation: Try pre-flight checks with real scenarios
Reporting bugs: Please open issues at github.com/serenichron/mcp-cloudron/issues
What's Next (Phase 2)
Once we validate these 15 tools, Phase 2 will add:
- App installation workflow
- User management (create/update/delete)
- Backup restore operations
- Enhanced logging and debugging
- Domain management
Thanks for any testing help! 
Package: @serenichron/mcp-cloudron v0.2.0
Cloudron version: 9.0.15