mcp-cloudron
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLOUDRON_BASE_URL | Yes | Your Cloudron instance URL (e.g., https://my.cloudron.io) | |
| CLOUDRON_API_TOKEN | Yes | API token from Cloudron Admin Panel |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cloudron_list_appsA | List all installed applications on the Cloudron instance. Returns app details including name, domain, status, and health. |
| cloudron_get_appC | Get detailed information about a specific application by its ID. |
| cloudron_get_statusB | Get the current status and configuration of the Cloudron instance. |
| cloudron_task_statusA | 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. |
| cloudron_cancel_taskA | 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). |
| cloudron_check_storageA | 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. |
| cloudron_validate_operationA | Pre-flight validation for destructive operations (uninstall app, delete user, restore backup). Returns validation result with blocking errors, warnings, and recommendations. |
| cloudron_control_appA | Control app lifecycle (start, stop, restart). Returns 202 Accepted with task ID for async operation tracking via cloudron_task_status. |
| cloudron_configure_appB | Update application configuration including environment variables, memory limits, and access control settings. Returns 200 OK with updated app config and restart requirement flag. |
| cloudron_list_backupsA | 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). |
| cloudron_create_backupA | 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). |
| cloudron_list_usersA | 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. |
| cloudron_search_appsA | 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. |
| cloudron_validate_manifestA | 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. |
| cloudron_create_userA | Create a new user on the Cloudron instance with role assignment (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. |
| cloudron_list_domainsA | List all configured domains on the Cloudron instance. Returns domain details including name, provider, verification status, and TLS configuration. |
| cloudron_get_logsB | 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. |
| cloudron_uninstall_appA | 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. |
| cloudron_install_appA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Each tool has a clearly distinct purpose with no significant overlap. For example, cloudron_control_app handles app lifecycle control, cloudron_configure_app manages configuration updates, and cloudron_get_logs retrieves logs, all targeting different aspects of the Cloudron system. The descriptions clearly differentiate between management, monitoring, validation, and operational tasks.
All tools follow a consistent snake_case naming pattern with a 'cloudron_' prefix and descriptive verb_noun combinations (e.g., cloudron_list_apps, cloudron_create_backup, cloudron_validate_manifest). This uniformity makes the tool set predictable and easy to navigate, with no deviations in style or structure.
With 19 tools, the count is slightly high but reasonable for a comprehensive Cloudron management server covering apps, backups, users, domains, and system operations. It includes essential CRUD operations, validation, and monitoring tools, though it could be streamlined by merging some validation or status-checking tools without losing functionality.
The tool set provides complete coverage for Cloudron instance management, including app lifecycle (install, configure, control, uninstall, list, search, get), backup operations (create, list), user management (create, list), domain listing, system status, logs, storage checks, and async task handling. There are no obvious gaps, and tools like cloudron_validate_manifest and cloudron_validate_operation ensure safety for destructive operations.