Validate an email address
email_checkCheck email syntax and whether the domain can receive mail (MX records). Flags common disposable domains. Cost: 1 credit per call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes |
email_checkCheck email syntax and whether the domain can receive mail (MX records). Flags common disposable domains. Cost: 1 credit per call.
| Name | Required | Description | Default |
|---|---|---|---|
| Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does disclose meaningful behavioral traits beyond the name: it performs DNS/MX lookups (implying network I/O and latency) and it charges 1 credit per call. That cost disclosure is genuinely useful and not derivable from any structured field. It still omits failure behavior and response shape, keeping it short of a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences plus a cost clause, all front-loaded: what is checked first, then the cost. No wasted words and nothing buried.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter, no-annotation, no-output-schema tool, the description covers what is validated and the cost. The remaining gap is what the result looks like (boolean vs. structured flags), but with no output schema and a trivial input this is close to sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% for the single 'email' parameter, and the description only implies the input is an email string without adding format, normalization, or edge-case detail beyond the 254-char maxLength already in the schema. Minimum-viable for a trivially simple single-param tool.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (check) and resource (email address), and enumerates the exact sub-checks performed: syntax, MX record deliverability, and disposable-domain flagging. An agent knows precisely what the tool returns conceptually without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The use case (validating an email before relying on it) is implied by the checks described, but there is no explicit when-to-use guidance. It does not state whether this is the right call versus related siblings like dns_lookup or domain_info, nor any exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.