Servidor MCP para interação com a Evolution API do WhatsApp
Server has 4 tools with basic schemas and descriptions in Portuguese. All tools have input schemas with type definitions and descriptions. However, descriptions are minimal (10-80 chars, below the 50-200 char baseline for LLM optimization), parameter descriptions lack actionable constraints (e.g., phone format, timeout bounds), and output schemas are completely undocumented. No error handling guidance, no idempotency hints, and no security/permission documentation. Tool naming follows verb_noun pattern (good), but lacks clarity on side effects and prerequisites.
Cria uma nova instância do WhatsApp na Evolution API
Obtém o QR code para conexão de uma instância do WhatsApp
Lista todas as instâncias do WhatsApp disponíveis na Evolution API
Envia uma mensagem de texto para um contato via WhatsApp
Output schemas completely undocumented. No tool returns a documented response structure. LLMs cannot plan downstream calls or extract required fields (e.g., does getWhatsAppQrCode return a URL, base64 image, or QR code object?).
Parameter descriptions lack actionable constraints. 'phoneNumber' says 'formato internacional' but does not specify: length, allowed characters, whether +55 prefix is required, or example format. 'timeout' lacks min/max bounds. LLMs will guess and pass invalid values.
Tool descriptions are too brief (10-80 chars vs. 50-200 char baseline). 'Cria uma nova instância' does not explain WHEN to use it, what prerequisites exist, or what happens on success/failure. LLMs cannot reliably select the right tool.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No error handling guidance. If sendWhatsAppMessage fails (invalid phone, rate limit, network error), the tool returns a raw error with no recovery hint. LLM cannot determine if it should retry, ask the user, or try a different approach.
No idempotency or side-effect documentation. createEvolutionInstance and sendWhatsAppMessage are destructive/irreversible, but descriptions do not warn the LLM. No confirmation step or dry-run option. Agents may retry and cause duplicate instances or duplicate messages.