MCP-compatible send_email tool adapter for Email SDK runtime with support for multiple email providers (Gmail, SendGrid, AWS SES, SMTP, ZeptoMail)
Single tool 'send_email' has a clear verb-noun name and proper JSON Schema with typed parameters (to, subject, body all strings, required array specified). However, the tool description is extremely brief (19 chars: 'Send transactional email'), falling below the 20-char minimum for meaningful LLM guidance. No parameter descriptions are visible in the schema, each param lacks a 'description' field explaining what it controls or accepts. The schema is minimal but present. No output schema is documented, leaving the LLM unaware of what fields to expect in the response (e.g., messageId, status, provider). No error handling guidance, recovery paths, or idempotency guarantees are specified. The tool lacks security annotations (no mention of credentials, permissions, or audit trails). Overall, this is a bare-minimum tool definition that would require significant enhancement for production use.
Send transactional email
Tool description is 19 characters ('Send transactional email'), below the 20-char minimum and lacks context for LLM selection. Does not explain WHEN to use this tool, what prerequisites exist, or what the response contains.
No parameter descriptions in schema. Each of 'to', 'subject', 'body' lacks a 'description' field. LLMs cannot infer that 'to' accepts email addresses, 'subject' is a line of text, or 'body' is HTML. Parameter names alone are insufficient.
No output schema documented. The tool definition does not specify what fields the response contains (e.g., messageId, status, provider, accepted, rejected). LLMs cannot plan downstream tool calls or extract required data without knowing the response structure.
No error handling or recovery guidance. Tool definition does not explain what errors can occur (invalid email, rate limit, provider failure) or what the LLM should do next. A bare error response gives the agent nothing to act on.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | <=2025-11-25 | v2 |
No security or permission declarations. Tool definition does not specify what credentials are required, whether the operation is logged/auditable, or what permissions the caller needs. No mention of idempotency or confirmation steps for this write operation.