MCP Server for RollDev + Magento 2 development workflow with project initialization
Server has 10 tools with complete input schemas and descriptions present for all tools and parameters. However, descriptions are generic and lack LLM-optimized guidance on WHEN to use each tool or what distinguishes similar operations. No output schemas documented. Parameter descriptions are minimal (avg ~30 chars vs baseline 72 chars). Many tools lack error handling guidance. No tool annotations (readOnlyHint/destructiveHint). Naming is consistent (verb_noun pattern) but some tools are overly similar (start_project vs start_svc). No pagination support documented despite tools that could return large results.
Run Composer commands inside the php-fpm container
Run a SQL query in the RollDev database
List all running RollDev environments with their directories (returns structured JSON)
Initialize a new Magento 2 project using RollDev's magento2-init command with automatic version configuration
Run roll magento command inside the php-fpm container
Run a PHP script inside the php-fpm container
Start a RollDev project environment
No output schemas documented. LLMs cannot plan downstream tool calls or extract structured data from responses. All 10 tools lack return type documentation.
Descriptions lack LLM-optimized guidance. Generic descriptions (avg 30-50 chars) do not explain WHEN to use each tool or distinguish similar operations (start_project vs start_svc, stop_project vs stop_svc). Baseline is 194 chars with context.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Start RollDev system services
Stop a RollDev project environment
Stop RollDev system services
No error handling guidance. Tools that execute commands (db_query, php_script, magento_cli, composer) can fail in many ways but provide no recovery hints. LLMs cannot self-correct without actionable error messages.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). LLMs cannot distinguish safe read-only tools from destructive operations. All 10 tools lack these critical hints.
Ambiguous tool naming: start_svc/stop_svc vs start_project/stop_project. LLMs conflate similar names. Clarify: does 'svc' mean system services, and how does it differ from project lifecycle? Add context to descriptions.