Wraps the Emailable email verification API (emailable.com) to verify whether email addresses are deliverable
Single tool with well-structured schema and clear description. Tool name 'emailable_verify' uses action verb appropriately. Input schema is complete with all parameters typed and described. Description (234 chars) is within optimal range and explains WHAT (email verification), WHEN (check deliverability), and WHAT it returns (state, score, flags). However, output schema is not formally documented, only visible through TypeScript interface VerifyResponse in code. Error handling is present but minimal (only HTTP 401/403 special-cased). No tool annotations (readOnlyHint, etc.) despite being read-only. Parameter '_apiKey' violates secret-injection pattern by appearing as a tool parameter rather than server-side injection.
Verify whether an email address is deliverable (`[email protected]`) — deliverability state, quality score, disposable/role/free flags, and typo suggestions. Uses Emailable's SMTP-level check (state is one of deliverable/undeliverable/risky/unknown; score is 0-100). A slow SMTP check can take up to 10s — that is expected. Example: emailable_verify({ email: "[email protected]", _apiKey: "live_..." })
API key exposed as tool parameter (_apiKey). Credentials must never appear in tool parameters, they leak into agent logs and traces. Use server-side secret injection via environment variables or vault.
Output schema not formally documented. Only visible as TypeScript interface VerifyResponse in code. LLMs need explicit schema documentation to plan downstream operations and extract fields correctly.
Tool lacks readOnlyHint annotation despite being read-only (no state modification). Tool annotations help agents understand safety and idempotency guarantees.
Error handling is minimal. Only HTTP 401/403 receive special messages; other errors (4xx, 5xx, network timeouts) return generic messages. Should provide actionable recovery guidance (e.g., 'Check your API key', 'Retry in 30s', 'Email format invalid').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Transport mechanism unknown. Source code shows custom implementation without explicit MCP protocol transport declaration (no HTTP, SSE, or STDIO markers visible). Cannot verify protocol compliance.