mcp-cloudron

List all installed applications on the Cloudron instance. Returns app details including name, domain, status, and health.

Get detailed information about a specific application by its ID.

Get the current status and configuration of the Cloudron instance.

Get the status of an async operation (backup, install, restore, etc.) by task ID. Returns state (pending/running/success/error/cancelled), progress (0-100%), and message.

Cancel a running async operation (kill switch). Returns updated task status with state "cancelled". Already completed tasks cannot be cancelled. Cancelled tasks cleanup resources (e.g., partial backups deleted).

Check available disk space before operations that create data (backup, install). Returns available/total/used disk space in MB, plus warning and critical threshold alerts.

Pre-flight validation for destructive operations (uninstall app, delete user, restore backup). Returns validation result with blocking errors, warnings, and recommendations.

Control app lifecycle (start, stop, restart). Returns 202 Accepted with task ID for async operation tracking via cloudron_task_status.

Update application configuration including environment variables, memory limits, and access control settings. Returns 200 OK with updated app config and restart requirement flag.

List all backups available on the Cloudron instance. Returns backup details including ID, timestamp, size, app count, and status. Backups are sorted by timestamp (newest first).

Create a new backup of the Cloudron instance. Performs F36 pre-flight storage check (requires 5GB minimum). Returns task ID for tracking backup progress via cloudron_task_status (F34).

List all users on the Cloudron instance. Returns user details including ID, email, username, role, and creation date. Users are sorted by role (admin, user, guest) then email.

Search the Cloudron App Store for available applications. Returns app details including name, description, version, icon URL, and install count. Results are sorted by relevance score. Empty query returns all available apps.

Validate app manifest before installation (pre-flight safety check). Checks storage sufficiency via F36, dependency availability, and manifest schema validity. Returns validation report with errors and warnings.

Create a new user on the Cloudron instance with email, password, and role in a single atomic operation. Password must be at least 8 characters long and contain at least 1 uppercase letter and 1 number. Returns 201 Created with user object.

Get detailed information about a specific user by user ID. Returns user object with email, username, display name, role, groups, and timestamps.

Update an existing user's properties including email, display name, password, role, or group membership. All fields are optional - only provided fields will be updated.

Delete a user from the Cloudron instance. WARNING: This is a destructive operation. Use cloudron_validate_operation before deletion to check for potential issues (last admin, owned apps). Requires confirmation flag set to true.

List all configured domains on the Cloudron instance. Returns domain details including name, provider, verification status, and TLS configuration.

Get logs for an app or service. Logs are formatted with timestamps and severity levels for readability. Type parameter determines endpoint: "app" calls GET /api/v1/apps/:id/logs, "service" calls GET /api/v1/services/:id/logs.

Uninstall an application with pre-flight safety validation. DESTRUCTIVE OPERATION. First validates via cloudron_validate_operation (checks app exists, no dependencies, backup recommended), then calls DELETE /api/v1/apps/:id. Returns 202 Accepted with task ID for async operation tracking.

Install application from Cloudron App Store with pre-flight validation. Calls F23a (cloudron_validate_manifest) to verify app exists and F36 (cloudron_check_storage) to ensure sufficient disk space. Returns task ID for async operation tracking via cloudron_task_status.

Check if Cloudron platform updates are available. Returns update information including availability, version, and changelog if an update exists.

Apply available Cloudron platform update. DESTRUCTIVE OPERATION - services will restart during update. Performs pre-flight validation to check update is available and recommends backup. Returns task ID for async operation tracking via cloudron_task_status.

List all groups on the Cloudron instance. Returns group details including ID, name, and creation date. Groups are sorted alphabetically by name.

Create a new group on the Cloudron instance. Groups can be used for access control and user organization.

List all platform services (read-only diagnostics). Returns status of Cloudron infrastructure services like databases (MySQL, PostgreSQL, MongoDB), mail, and other platform components. This is diagnostic information - services are managed automatically by Cloudron.

Create a backup of a specific application. Performs pre-flight storage check (requires 5GB minimum). Returns task ID for async operation tracking via cloudron_task_status.

Restore an application from a backup. DESTRUCTIVE OPERATION - current app data will be replaced. Performs pre-flight validation to check backup exists and storage is sufficient. Returns task ID for async operation tracking via cloudron_task_status.

Clone an existing application to a new location. Creates a duplicate of the app with its data and configuration. Performs pre-flight validation to check source app exists and target location is available. Returns task ID for async operation tracking via cloudron_task_status.

Repair a broken application. Attempts automatic repair of apps in error state. Use when an app is unhealthy or has installation issues. Returns task ID for async operation tracking via cloudron_task_status.

Update an application to a newer version. Performs pre-flight validation to check app exists and is in installed state. Returns task ID for async operation tracking via cloudron_task_status.

Fetch real package examples from git.cloudron.io. Finds the repository for a given App Store ID and returns the content of key files (CloudronManifest.json, Dockerfile, start.sh).

Get interactive, topic-specific guidance for creating Cloudron packages. Provides documentation, best practices, and reference implementation examples for packaging web applications for Cloudron.

Generate a complete Cloudron package scaffold with all required files (CloudronManifest.json, Dockerfile, start.sh, test/test.js). Provides ready-to-use templates customized for your application type, addons, and authentication method.

Validate Cloudron package files (CloudronManifest.json, Dockerfile, start.sh) for errors and best practices. Returns detailed validation report with errors, warnings, and suggestions.