- Home
- Skills
- APIs & Backend
- aapanel
Works with the AI Agents you already use
aapanel
Manage aaPanel hosting servers, sites, databases, and security via MCP with 280+ tools and built-in safety guards.
Free
aapanel
Example session with this skill installed
Check the health of my 'prod-01' server. If the disk is over 90%, find the largest directories in /www/wwwroot and list any site logs we can safely clear.
- Read your context and instructions
- Compiled the aapanel
I have performed a health check on the
prod-01 server. The disk usage is currently at 94%, which exceeds your 90% threshold.
Server Health Audit: prod-01
| Metric | Value | Status |
|---|---|---|
| CPU Usage | 12.5% | Healthy |
| Memory | 4.2GB / 16GB | Healthy |
| Disk Usage | 470GB / 500GB (94%) | Critical |
| Load Average | 0.85, 0.90, 1.10 | Healthy |
Large Directory Analysis
I scanned /www/wwwroot to identify storage consumers:
/www/wwwroot/dev.example.com/logs: 45GB/www/wwwroot/app.example.com/uploads: 22GB/www/wwwroot/old-backup-site: 18GB
Potential Cleanup Actions
The following site logs can be cleared to reclaim space:
dev.example.com: 45GB available (usingsystem_clear_site_logs)staging.test: 1.2GB available
Next steps
- Run
system_clear_site_logsfordev.example.comto reclaim 45GB. Please confirm if I should proceed withconfirmed=true. - Investigate the
old-backup-sitedirectory to see if it can be archived or deleted. - Check
storage_get_dir_sizeon/www/backupto see if old database dumps are accumulating.
Connects securely to your tools. The creator never sees your data.
About this skill
Managing a fleet of aaPanel or BT Panel hosting servers usually requires jumping between multiple web UIs and manual terminal commands. This skill connects your agent to the aapanel-mcp server, providing 282 tools to automate website deployment, database management, and server hardening across multiple panels from a single interface.
What it does
- Automate site deployment by creating webroots, configuring PHP versions, and issuing Let's Encrypt SSL certificates in one flow.
- Manage databases and FTP including user creation, access control, and automated backup scheduling.
- Monitor server health with real-time CPU, memory, and disk usage stats, plus anomaly detection for MySQL and PHP.
- Enforce security hardening through baseline scans, SSH key configuration, IP whitelisting, and CVE vulnerability checks.
- Orchestrate Docker containers by listing, starting, or stopping services directly through the panel API.
- Execute terminal commands via the aaPanel Terminal Bridge for tasks not covered by standard API modules.
How it works
- Install the
aapanel-mcpserver via pip or uvx and enable the API Interface in your aaPanel settings. - Define your panel credentials (host, token) in the
servers.yamlconfiguration file. - Invoke tools using the
<module>_<action>convention, such assite_createordatabase_backup. - Provide a
serverparameter to target specific panels in a multi-server environment.
Frameworks & tools
This skill requires the aapanel-mcp Python package. It interacts with aaPanel (v8.x) and BT Panel via their REST API interfaces. It supports integration with Docker, Let's Encrypt, Redis, and Memcached when the corresponding plugins are active on the host.
Why this beats prompting it yourself
Writing manual scripts for the aaPanel API is error-prone due to endpoint drift and complex payload requirements. This skill includes a hardcoded safety guard that prevents accidental deletion of system-critical directories like /etc or /boot, which a raw LLM might otherwise attempt.
Use cases
- Deploy a full WordPress or PHP stack with SSL and a database in a single prompt.
- Audit a fleet of servers for high resource usage and clear logs on full disks.
- Patch active CVE vulnerabilities across multiple runtimes and verify the fix.
- Manage firewall rules and SSH access to harden new server instances.
Known limitations
Tested primarily on aaPanel 8.0.x; 7.x compatibility is not verified. Destructive actions require a manual confirmed=true flag and cannot be fully automated without user intervention.
Tested on aaPanel 8.0.4/8.0.7. v7.x untested. Deleting system files or databases is permanently blocked. Destructive actions require manual confirmation flags.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 26 days ago
- Free with an Agensi account
Requires
Permissions
File Scopes
Terminal/Shell — one-time setup only: installs the aapanel-mcp server (pip install aapanel-mcp or uvx aapanel-mcp) and creates ~/.aapanel-mcp/. Read & Write Files — creates/edits ~/.aapanel-mcp/servers.yaml (panel URL + API token) and the MCP client config (e.g. mcp.json) that registers the server. Environment Variables — AAPANEL_CONFIG_PATH (optional) and the env block in the mcpServers config pass the config path to the server. Network Access — the skill manages aaPanel/BT Panel servers over their REST API. All traffic flows through the aapanel-mcp MCP server process (agent → MCP server → panel); the agent itself makes no direct HTTP calls. A built-in safety guard permanently blocks deletion of critical system paths (/etc, /www/server, /www/wwwroot, ...) and system databases, and requires explicit user confirmation before any destructive action. Browser — not used by this skill.