flimap has well-structured tool definitions with consistent naming (verb_noun pattern), clear descriptions (avg 120 chars), and complete input schemas with type annotations. All 12 tools follow the verb-first convention (list_, search_, get_, send_, move_, mark_, delete_, create_, rename_). Descriptions are concise and action-oriented. However, output schemas are inferred from Go struct tags rather than explicitly documented in the tool registration, and several tools lack parameter constraints (enums, ranges). Error handling is present but minimal, most errors are generic fmt.Errorf calls without recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications. Parameter descriptions are adequate but could specify ranges/formats more explicitly (e.g., 'limit: 1-200' vs 'max: 200').
Create a new mailbox folder.
Delete a mailbox folder.
Delete a message. If the folder is INBOX, moves to Trash. If the folder is Trash, permanently deletes.
Return a full message including body and attachments.
List all mailbox folders with message counts, listed recursively. Container folders (\Noselect) are included but marked as not selectable.
Return recent messages from a folder. If the folder is a virtual address folder, searches All Mail filtered by To: header.
Output schemas not explicitly documented in tool registration. Go struct tags define output shape, but MCP tool definitions should include explicit outputSchema in JSON Schema format for LLM visibility.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications. Tools like delete_message and delete_folder are marked DESTRUCTIVE but lack destructiveHint annotation to guide agent behavior.
Parameter constraints not formalized as enums or ranges. 'limit' parameters state 'max: 200' in description text but lack JSON Schema maxValue constraints. Folder names accept free-form strings with no validation guidance.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | <=2025-11-25 | v2 |
Mark a message as read by setting the \Seen flag.
Mark a message as unread by removing the \Seen flag.
Move a message from one folder to another.
Rename an existing mailbox folder.
Search for messages matching a text query. If the folder is a virtual address folder, searches within All Mail filtered by To: header.
Compose and send an email via SMTP.
Error handling lacks recovery guidance. Errors are generic fmt.Errorf calls (e.g., 'uid is required', 'query is required') without actionable next steps or error classification (retryable vs user-fixable).
Folder parameter defaults ('default: INBOX') documented in descriptions but not enforced in schema. LLMs may not reliably omit optional params; explicit defaults in schema improve clarity.