MCP server for FastPanel 2 — manage sites, databases, DNS, users via Model Context Protocol
Strong foundation with 11 well-named, read-only tools. All tools have clear descriptions (avg 180 chars, within 10-1024 baseline). Input schemas present with Zod validation. Tool annotations (readOnlyHint, destructiveHint, idempotentHint) correctly applied. Key gaps: output schemas not documented in descriptions; no pagination guidance for list tools despite 'limit' params; error handling returns raw API responses without recovery guidance; no parameter constraints documented in descriptions (e.g., 'positive integer, max 10000' visible in schema but not in description text for sites_list.limit).
List all SSL certificates stored in FastPanel (Let's Encrypt and custom). Returns id, name, type, common_name, alternative_name, expiration, linked site. Also injects computed crt_path/key_path — the on-disk paths FastPanel writes certs to (/var/www/httpd-cert/<name>.crt|.key). These are needed when hand-writing a 443 server block after a site is in manual_changes mode. NOTE: the paths are derived from FastPanel's naming convention, not returned by the API — verify on disk (ls /var/www/httpd-cert/) if a cert was imported rather than issued by the panel.
List available database servers (MySQL, PostgreSQL). Use the returned ids as server_id in database_create and site_create.
List all MySQL and PostgreSQL databases. Returns id, name, charset, size, owner, linked site, server, last dump timestamp.
List all DNS zones managed by FastPanel's DNS service. Empty if DNS is not configured.
List all DNS records for a specific domain (zone) by its id. Use dns_domains_list first to get ids.
Output schemas not documented. Tool descriptions state what fields are returned (e.g., 'Returns id, name, charset, size...') but do not specify the structure LLMs should expect. Missing formal output schema documentation forces LLMs to infer structure from examples.
Parameter constraints visible in schema but not in description text. sites_list.limit has 'max(10000)' in Zod but description says 'Max rows to return' without stating the 10000 ceiling. LLMs cannot read JSON Schema constraints, they rely on description text.
Error handling returns raw API responses without recovery guidance. asError() function returns 'Response body: {...}' JSON dump. LLMs cannot act on raw API errors, they need 'Try X next' or 'This is retryable' classification.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Poll FastPanel background tasks and get a deterministic done/not-done signal. The raw /api/queue endpoint also returns recently-FINISHED tasks (status SUCCESS/FAILED), which makes naive polling ambiguous. This tool filters to genuinely in-flight tasks by default and adds meta.all_done (true when nothing is still running) so you can loop until done. Set include_finished:true to also see the just-completed tasks (useful to learn whether an async op SUCCEEDED or FAILED).
List active and recent FastPanel background tasks (backups, migrations, SSL issuance, screenshots, etc) including completed ones.
Get full details for a single site by id. Returns all 40 fields including SSL certificate, backend config, permissions, backup plan, stats.
List all websites managed by FastPanel. Compact mode (default) returns only essential fields — full response is ~3KB per site and can overflow context. Use site_get(id) for full details of a specific site.
Get current server load metrics — CPU, memory, disk, uptime. Source: FastPanel's internal /api/loads/full endpoint.
List all FastPanel system users (site owners). Returns id, username, home_dir, roles, PHP version, quota, ssh_access, enabled flag.
List tools lack pagination guidance. sites_list, databases_list, users_list, dns_domains_list, queue_list accept 'limit' but descriptions do not explain pagination strategy (offset vs cursor), whether results are sorted, or how to fetch next page.
certificates_list description includes implementation detail ('paths are derived from FastPanel's naming convention, not returned by the API, verify on disk'). This is a warning, not a tool description. Should be moved to a note or separate validation tool.