The server defines 2 tools with reasonable schemas and descriptions, but has gaps in parameter validation, error handling guidance, and output documentation. Both tools use Pydantic models with proper type definitions and descriptions, which is a baseline. However, error messages lack recovery guidance (critical for pattern:recovery-guide), parameter constraints are underspecified, and output schemas are not formally documented. The resource tool (listar_tarefas_pendentes) is well-implemented but is not a tool, so it doesn't factor into the tool scoring.

• Add error recovery guidance: 'Invalid status value. Valid options are: A Fazer, Em Progresso, Concluído. Use listar_tarefas_pendentes() to see current statuses.' Replace raw exception returns with structured error objects containing error_type, user_message, and suggested_next_tool.
• Declare valid status enum in concluir_tarefa schema: {"status": {"type": "string", "enum": ["A Fazer", "Em Progresso", "Concluído"], "description": "New status of the task. Must be one of the valid Notion statuses."}}
• Document output schemas in tool descriptions. Example: 'Returns a JSON object with keys: success (bool), task_id (string), task_url (string), created_at (ISO 8601 timestamp).' Then return structured objects instead of free-form strings.
• Add toolAnnotation destructiveHint to both tools. In fastmcp, use @app.tool(meta={'destructiveHint': True}) or similar to mark these as write operations.
• Add parameter relationship documentation: In criar_tarefa description, note 'If you need to update an existing task, use concluir_tarefa with the page_id. To find existing tasks, call listar_tarefas_pendentes().'
• Validate page_id format in concluir_tarefa before calling the Notion API. Return a clear error: 'Invalid page_id format. Expected a UUID or ID from listar_tarefas_pendentes(). Got: {invalid_value}.'
• Document Notion schema dependencies: Add a note that criar_tarefa and concluir_tarefa assume the Notion database has columns named 'Name', 'Status', and 'Prazo'. If these don't match, return a setup error: 'Notion database schema mismatch. Expected columns: Name, Status, Prazo. Please check NOTION_DATABASE_ID or reconfigure the tool.'