mcp-email-validator 0.2.0__tar.gz

mcp_email_validator-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jayanth MKV
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_email_validator-0.2.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: mcp-email-validator
+Version: 0.2.0
+Summary: A safety-bounded MCP server for email syntax, DNS, and opt-in SMTP checks
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: dnspython>=2.9.0,<3
+Requires-Dist: fastmcp>=4.1.4,<5
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/jayanth-mkv/agent-mcp-registry
+Project-URL: Documentation, https://github.com/jayanth-mkv/agent-mcp-registry/tree/main/mcp-email-validator
+Project-URL: Repository, https://github.com/jayanth-mkv/agent-mcp-registry
+Project-URL: Issues, https://github.com/jayanth-mkv/agent-mcp-registry/issues
+Description-Content-Type: text/markdown
+
+# Email Validator MCP
+
+An MCP server for checking email syntax and DNS mail routes without sending a message. Optional SMTP probing provides a recipient acceptance signal; it does not prove ownership or guarantee delivery.
+
+## Install a published release
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+uvx --python 3.13 mcp-email-validator@0.2.0
+```
+
+Published versions are listed on [PyPI](https://pypi.org/project/mcp-email-validator/). If the version is not available yet, use the GitHub command below. Publishing is managed through [GitHub Actions](https://github.com/jayanth-mkv/agent-mcp-registry/blob/main/docs/publishing.md).
+
+## Run from GitHub without cloning
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git. uv downloads the selected package and manages Python 3.13 and its dependencies:
+
+```bash
+uvx --python 3.13 --from "git+https://github.com/jayanth-mkv/agent-mcp-registry.git@main#subdirectory=mcp-email-validator" mcp-email-validator
+```
+
+Only this MCP and its runtime dependencies are installed. uv fetches the repository internally; you do not need a local checkout. To pin the source, replace `main` with a release tag or full commit SHA.
+
+## Install from source
+
+From this directory, with Python 3.13+ and [uv](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+uv sync --locked --no-dev
+uv run --locked --no-dev mcp-email-validator
+```
+
+The default transport is stdio. Configure your MCP client using the [repository example](https://github.com/jayanth-mkv/agent-mcp-registry#connect-an-mcp-client). No API key is required; DNS checks need network access.
+
+For Streamable HTTP:
+
+```bash
+uv run --locked --no-dev mcp-email-validator --transport http --host 127.0.0.1 --port 8003
+```
+
+Endpoint: `http://127.0.0.1:8003/mcp`. Legacy SSE is available with `--transport sse` at `/sse`. HTTP and SSE have no authentication; keep them on loopback unless protected separately.
+
+## Tools
+
+| Tool | Required argument | Optional arguments |
+| --- | --- | --- |
+| `validate_email` | `address: string` | `check_smtp=false`, `timeout_seconds=10` |
+| `validate_email_batch` | `addresses: string[]` (up to 50) | `check_smtp=false`, `timeout_seconds=10` |
+
+Both tools check conventional unquoted mailbox syntax and normalize the domain, then look up MX records. Domains without MX records may use A/AAAA fallback; a null MX means the domain does not accept mail. Invalid syntax skips DNS and SMTP.
+
+Example tool arguments:
+
+```json
+{ "address": "user@example.com", "check_smtp": false }
+```
+
+Results contain `normalized_address`, `syntax_valid`, `mail_route_status`, `mail_hosts`, `smtp_status`, and explanatory `notes`.
+
+| Field | Possible values |
+| --- | --- |
+| `mail_route_status` | `not_checked`, `found`, `fallback`, `not_found`, `lookup_error` |
+| `smtp_status` | `not_requested`, `accepted`, `rejected`, `unavailable`, `error` |
+
+## SMTP boundaries
+
+SMTP probing is disabled unless `check_smtp=true`. It tries at most three mail hosts, connects to one public IP per host on port 25, and uses SMTP greeting, sender, and recipient commands. It never sends `DATA` or authenticates. DNS lookups and socket operations use a timeout clamped to 1–15 seconds; this is not a total request deadline, and batches run sequentially.
+
+Use probing only for infrastructure and addresses you are authorized to assess. Catch-all domains, greylisting, sender policy, and anti-abuse controls can produce misleading results. Private and loopback IP addresses are not contacted. Address data is not written to an application database; DNS queries and optional SMTP probes are visible to the contacted infrastructure.
+
+## Development
+
+```bash
+uv sync --locked
+uv run --locked pytest -q
+uv build
+```
+
+Tests mock DNS/SMTP network operations and exercise the installed stdio server. Live recipient acceptance and delivery are separate checks.
+
+Version 0.2.0. Licensed under the [MIT License](https://github.com/jayanth-mkv/agent-mcp-registry/blob/main/mcp-email-validator/LICENSE).

mcp_email_validator-0.2.0/README.md

@@ -0,0 +1,82 @@
+# Email Validator MCP
+
+An MCP server for checking email syntax and DNS mail routes without sending a message. Optional SMTP probing provides a recipient acceptance signal; it does not prove ownership or guarantee delivery.
+
+## Install a published release
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+uvx --python 3.13 mcp-email-validator@0.2.0
+```
+
+Published versions are listed on [PyPI](https://pypi.org/project/mcp-email-validator/). If the version is not available yet, use the GitHub command below. Publishing is managed through [GitHub Actions](https://github.com/jayanth-mkv/agent-mcp-registry/blob/main/docs/publishing.md).
+
+## Run from GitHub without cloning
+
+Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git. uv downloads the selected package and manages Python 3.13 and its dependencies:
+
+```bash
+uvx --python 3.13 --from "git+https://github.com/jayanth-mkv/agent-mcp-registry.git@main#subdirectory=mcp-email-validator" mcp-email-validator
+```
+
+Only this MCP and its runtime dependencies are installed. uv fetches the repository internally; you do not need a local checkout. To pin the source, replace `main` with a release tag or full commit SHA.
+
+## Install from source
+
+From this directory, with Python 3.13+ and [uv](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+uv sync --locked --no-dev
+uv run --locked --no-dev mcp-email-validator
+```
+
+The default transport is stdio. Configure your MCP client using the [repository example](https://github.com/jayanth-mkv/agent-mcp-registry#connect-an-mcp-client). No API key is required; DNS checks need network access.
+
+For Streamable HTTP:
+
+```bash
+uv run --locked --no-dev mcp-email-validator --transport http --host 127.0.0.1 --port 8003
+```
+
+Endpoint: `http://127.0.0.1:8003/mcp`. Legacy SSE is available with `--transport sse` at `/sse`. HTTP and SSE have no authentication; keep them on loopback unless protected separately.
+
+## Tools
+
+| Tool | Required argument | Optional arguments |
+| --- | --- | --- |
+| `validate_email` | `address: string` | `check_smtp=false`, `timeout_seconds=10` |
+| `validate_email_batch` | `addresses: string[]` (up to 50) | `check_smtp=false`, `timeout_seconds=10` |
+
+Both tools check conventional unquoted mailbox syntax and normalize the domain, then look up MX records. Domains without MX records may use A/AAAA fallback; a null MX means the domain does not accept mail. Invalid syntax skips DNS and SMTP.
+
+Example tool arguments:
+
+```json
+{ "address": "user@example.com", "check_smtp": false }
+```
+
+Results contain `normalized_address`, `syntax_valid`, `mail_route_status`, `mail_hosts`, `smtp_status`, and explanatory `notes`.
+
+| Field | Possible values |
+| --- | --- |
+| `mail_route_status` | `not_checked`, `found`, `fallback`, `not_found`, `lookup_error` |
+| `smtp_status` | `not_requested`, `accepted`, `rejected`, `unavailable`, `error` |
+
+## SMTP boundaries
+
+SMTP probing is disabled unless `check_smtp=true`. It tries at most three mail hosts, connects to one public IP per host on port 25, and uses SMTP greeting, sender, and recipient commands. It never sends `DATA` or authenticates. DNS lookups and socket operations use a timeout clamped to 1–15 seconds; this is not a total request deadline, and batches run sequentially.
+
+Use probing only for infrastructure and addresses you are authorized to assess. Catch-all domains, greylisting, sender policy, and anti-abuse controls can produce misleading results. Private and loopback IP addresses are not contacted. Address data is not written to an application database; DNS queries and optional SMTP probes are visible to the contacted infrastructure.
+
+## Development
+
+```bash
+uv sync --locked
+uv run --locked pytest -q
+uv build
+```
+
+Tests mock DNS/SMTP network operations and exercise the installed stdio server. Live recipient acceptance and delivery are separate checks.
+
+Version 0.2.0. Licensed under the [MIT License](https://github.com/jayanth-mkv/agent-mcp-registry/blob/main/mcp-email-validator/LICENSE).

mcp_email_validator-0.2.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "mcp-email-validator"
+version = "0.2.0"
+description = "A safety-bounded MCP server for email syntax, DNS, and opt-in SMTP checks"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = [
+    "dnspython>=2.9.0,<3",
+    "fastmcp>=4.1.4,<5",
+]
+
+[project.urls]
+Homepage = "https://github.com/jayanth-mkv/agent-mcp-registry"
+Documentation = "https://github.com/jayanth-mkv/agent-mcp-registry/tree/main/mcp-email-validator"
+Repository = "https://github.com/jayanth-mkv/agent-mcp-registry"
+Issues = "https://github.com/jayanth-mkv/agent-mcp-registry/issues"
+
+[project.scripts]
+mcp-email-validator = "mcp_email_validator.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=9.2.0,<10"]
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14"]
+build-backend = "uv_build"

mcp_email_validator-0.2.0/pyproject.toml.orig

@@ -0,0 +1,28 @@
+[project]
+name = "mcp-email-validator"
+version = "0.2.0"
+description = "A safety-bounded MCP server for email syntax, DNS, and opt-in SMTP checks"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = [
+  "dnspython>=2.9.0,<3",
+  "fastmcp>=4.1.4,<5",
+]
+
+[project.urls]
+Homepage = "https://github.com/jayanth-mkv/agent-mcp-registry"
+Documentation = "https://github.com/jayanth-mkv/agent-mcp-registry/tree/main/mcp-email-validator"
+Repository = "https://github.com/jayanth-mkv/agent-mcp-registry"
+Issues = "https://github.com/jayanth-mkv/agent-mcp-registry/issues"
+
+[project.scripts]
+mcp-email-validator = "mcp_email_validator.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=9.2.0,<10"]
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14"]
+build-backend = "uv_build"

mcp_email_validator-0.2.0/src/mcp_email_validator/__init__.py

@@ -0,0 +1,18 @@
+"""Email Validator MCP server package."""
+
+from __future__ import annotations
+
+from .mcp import mcp
+from .tools import validate_email, validate_email_batch
+
+__all__ = ["mcp", "run", "validate_email", "validate_email_batch"]
+
+
+def run(
+    host: str = "127.0.0.1", port: int = 8003, transport: str = "stdio"
+) -> None:
+    """Run the server with the requested local transport."""
+    if transport in {"sse", "http"}:
+        mcp.run(transport=transport, host=host, port=port)
+    else:
+        mcp.run(transport=transport)

mcp_email_validator-0.2.0/src/mcp_email_validator/cli.py

@@ -0,0 +1,38 @@
+"""Command-line entry point for Email Validator MCP."""
+
+from __future__ import annotations
+
+import argparse
+
+from . import run
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="Run the Email Validator MCP server.")
+    parser.add_argument(
+        "--transport",
+        choices=["stdio", "sse", "http"],
+        default="stdio",
+        help="MCP transport (default: stdio).",
+    )
+    parser.add_argument(
+        "--host",
+        default="127.0.0.1",
+        help="Host for HTTP or SSE transport (default: 127.0.0.1).",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=8003,
+        help="Port for HTTP or SSE transport (default: 8003).",
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = build_parser().parse_args(argv)
+    run(host=args.host, port=args.port, transport=args.transport)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

mcp_email_validator-0.2.0/src/mcp_email_validator/mcp.py

@@ -0,0 +1,5 @@
+"""FastMCP application instance for the email validation server."""
+
+from fastmcp import FastMCP
+
+mcp = FastMCP(name="Email Validator", version="0.2.0")

mcp_email_validator-0.2.0/src/mcp_email_validator/tools.py

@@ -0,0 +1,35 @@
+"""MCP tool definitions for bounded email validation."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .mcp import mcp
+from .validation import MAX_BATCH_SIZE, validate_address, validate_batch
+
+
+@mcp.tool
+def validate_email(
+    address: str, check_smtp: bool = False, timeout_seconds: float = 10.0
+) -> dict[str, Any]:
+    """Check one email's syntax and mail route; SMTP probing is opt-in and sends no mail."""
+    return validate_address(
+        address, check_smtp=check_smtp, timeout_seconds=timeout_seconds
+    )
+
+
+@mcp.tool
+def validate_email_batch(
+    addresses: list[str], check_smtp: bool = False, timeout_seconds: float = 10.0
+) -> list[dict[str, Any]]:
+    """Validate up to 50 addresses with optional, bounded SMTP recipient probes."""
+    if len(addresses) > MAX_BATCH_SIZE:
+        return [
+            {
+                "error": f"Batch limit exceeded: submit at most {MAX_BATCH_SIZE} addresses.",
+                "smtp_status": "not_requested",
+            }
+        ]
+    return validate_batch(
+        addresses, check_smtp=check_smtp, timeout_seconds=timeout_seconds
+    )

mcp_email_validator-0.2.0/src/mcp_email_validator/validation.py

@@ -0,0 +1,219 @@
+"""Pure validation and deliberately bounded network-check helpers."""
+
+from __future__ import annotations
+
+import ipaddress
+import re
+import smtplib
+from collections.abc import Iterable
+from typing import Any
+
+import dns.exception
+import dns.resolver
+
+MAX_ADDRESS_LENGTH = 254
+MAX_LOCAL_PART_LENGTH = 64
+MAX_BATCH_SIZE = 50
+MAX_SMTP_HOSTS = 3
+MIN_TIMEOUT_SECONDS = 1.0
+MAX_TIMEOUT_SECONDS = 15.0
+LOCAL_PART_PATTERN = re.compile(r"^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+$")
+
+
+def _bounded_timeout(value: float) -> float:
+    """Return a usable timeout without allowing callers to make probes linger."""
+    return max(MIN_TIMEOUT_SECONDS, min(float(value), MAX_TIMEOUT_SECONDS))
+
+
+def _normalise_address(address: str) -> tuple[str | None, str | None, str | None]:
+    """Validate a conventional address and return normalized address and domain."""
+    candidate = address.strip()
+    if not candidate or len(candidate) > MAX_ADDRESS_LENGTH:
+        return None, None, "Address must be between 1 and 254 characters."
+    if candidate.count("@") != 1:
+        return None, None, "Address must contain one @ separator."
+
+    local_part, domain = candidate.rsplit("@", 1)
+    if not local_part or len(local_part) > MAX_LOCAL_PART_LENGTH:
+        return None, None, "Local part must be between 1 and 64 characters."
+    if not LOCAL_PART_PATTERN.fullmatch(local_part):
+        return None, None, "Local part contains unsupported characters."
+    if local_part.startswith(".") or local_part.endswith(".") or ".." in local_part:
+        return None, None, "Local part cannot begin, end, or repeat a dot."
+
+    try:
+        ascii_domain = domain.encode("idna").decode("ascii").lower()
+    except UnicodeError:
+        return None, None, "Domain cannot be converted to IDNA."
+    if len(ascii_domain) > 253 or "." not in ascii_domain:
+        return None, None, "Domain must be a fully qualified hostname."
+
+    labels = ascii_domain.split(".")
+    if any(
+        not label
+        or len(label) > 63
+        or label.startswith("-")
+        or label.endswith("-")
+        or not all(character.isalnum() or character == "-" for character in label)
+        for label in labels
+    ):
+        return None, None, "Domain contains an invalid hostname label."
+
+    return f"{local_part}@{ascii_domain}", ascii_domain, None
+
+
+def _resolver(timeout_seconds: float) -> dns.resolver.Resolver:
+    resolver = dns.resolver.Resolver(configure=True)
+    resolver.timeout = timeout_seconds
+    resolver.lifetime = timeout_seconds
+    return resolver
+
+
+def _resolve_mail_hosts(domain: str, timeout_seconds: float) -> tuple[str, list[str], list[str]]:
+    """Find MX hosts, falling back to the domain only when RFC fallback is possible."""
+    resolver = _resolver(timeout_seconds)
+    try:
+        answers = resolver.resolve(domain, "MX")
+        records = sorted(
+            (int(record.preference), str(record.exchange).rstrip(".")) for record in answers
+        )
+        if any(host == "" for _, host in records):
+            return "not_found", [], ["The domain publishes a null MX record and does not accept email."]
+        hosts = [host for _, host in records]
+        return "found", hosts, ["MX records were found for the domain."]
+    except dns.resolver.NoAnswer:
+        pass
+    except dns.resolver.NXDOMAIN:
+        return "not_found", [], ["The domain does not exist in DNS."]
+    except dns.exception.Timeout:
+        return "lookup_error", [], ["DNS lookup timed out before mail routes could be confirmed."]
+    except dns.exception.DNSException:
+        return "lookup_error", [], ["DNS lookup failed before mail routes could be confirmed."]
+
+    try:
+        resolver.resolve(domain, "A")
+        return "fallback", [domain], ["No MX record; the domain has an A record and may use implicit MX fallback."]
+    except dns.resolver.NoAnswer:
+        pass
+    except dns.resolver.NXDOMAIN:
+        return "not_found", [], ["The domain does not exist in DNS."]
+    except dns.exception.Timeout:
+        return "lookup_error", [], ["DNS lookup timed out before mail routes could be confirmed."]
+    except dns.exception.DNSException:
+        return "lookup_error", [], ["DNS lookup failed before mail routes could be confirmed."]
+
+    try:
+        resolver.resolve(domain, "AAAA")
+        return "fallback", [domain], ["No MX record; the domain has an AAAA record and may use implicit MX fallback."]
+    except dns.resolver.NoAnswer:
+        return "not_found", [], ["No MX, A, or AAAA mail route was found for the domain."]
+    except dns.resolver.NXDOMAIN:
+        return "not_found", [], ["The domain does not exist in DNS."]
+    except dns.exception.Timeout:
+        return "lookup_error", [], ["DNS lookup timed out before mail routes could be confirmed."]
+    except dns.exception.DNSException:
+        return "lookup_error", [], ["DNS lookup failed before mail routes could be confirmed."]
+
+
+def _public_ip_for_host(host: str, timeout_seconds: float) -> str | None:
+    """Resolve one publicly routable address, avoiding private-network SMTP probes."""
+    resolver = _resolver(timeout_seconds)
+    for record_type in ("A", "AAAA"):
+        try:
+            answers = resolver.resolve(host, record_type)
+        except dns.resolver.NoAnswer:
+            continue
+        except dns.exception.DNSException:
+            return None
+        for answer in answers:
+            try:
+                candidate = ipaddress.ip_address(str(answer))
+            except ValueError:
+                continue
+            if candidate.is_global:
+                return str(candidate)
+    return None
+
+
+def _probe_smtp(address: str, hosts: Iterable[str], timeout_seconds: float) -> tuple[str, list[str]]:
+    """Attempt the smallest SMTP conversation needed for a recipient signal."""
+    attempted_hosts = 0
+    errors: list[str] = []
+    for host in list(hosts)[:MAX_SMTP_HOSTS]:
+        public_ip = _public_ip_for_host(host, timeout_seconds)
+        if not public_ip:
+            errors.append(f"{host}: no publicly routable address was available")
+            continue
+
+        attempted_hosts += 1
+        try:
+            with smtplib.SMTP(host=public_ip, port=25, timeout=timeout_seconds) as client:
+                client.ehlo_or_helo_if_needed()
+                mail_code, _ = client.mail("mcp-email-validator@invalid.example")
+                if mail_code >= 400:
+                    errors.append(f"{host}: server did not accept the probe sender")
+                    continue
+                recipient_code, _ = client.rcpt(address)
+        except (OSError, smtplib.SMTPException):
+            errors.append(f"{host}: SMTP connection or protocol check failed")
+            continue
+
+        if 200 <= recipient_code < 300:
+            return "accepted", [f"A recipient command was accepted by {host}."]
+        if 500 <= recipient_code < 600:
+            return "rejected", [f"A recipient command was rejected by {host}."]
+        errors.append(f"{host}: SMTP server returned a temporary or indeterminate recipient response")
+
+    if not attempted_hosts:
+        return "unavailable", errors or ["No eligible public mail host was available for SMTP probing."]
+    return "error", errors or ["SMTP probing did not produce a recipient response."]
+
+
+def validate_address(
+    address: str, *, check_smtp: bool = False, timeout_seconds: float = 10.0
+) -> dict[str, Any]:
+    """Return bounded syntax, DNS, and optional SMTP facts for one address."""
+    timeout = _bounded_timeout(timeout_seconds)
+    normalized, domain, syntax_error = _normalise_address(address)
+    result: dict[str, Any] = {
+        "address": address,
+        "normalized_address": normalized,
+        "syntax_valid": syntax_error is None,
+        "domain": domain,
+        "mail_route_status": "not_checked",
+        "mail_hosts": [],
+        "smtp_status": "not_requested",
+        "notes": [],
+    }
+    if syntax_error:
+        result["notes"] = [syntax_error, "DNS and SMTP checks were skipped."]
+        return result
+
+    route_status, hosts, route_notes = _resolve_mail_hosts(domain, timeout)
+    result["mail_route_status"] = route_status
+    result["mail_hosts"] = hosts
+    result["notes"] = route_notes
+    if not check_smtp:
+        result["notes"].append("SMTP probing was not requested.")
+        return result
+    if not hosts:
+        result["smtp_status"] = "unavailable"
+        result["notes"].append("SMTP probing was skipped because no mail host was available.")
+        return result
+
+    smtp_status, smtp_notes = _probe_smtp(normalized, hosts, timeout)
+    result["smtp_status"] = smtp_status
+    result["notes"].extend(smtp_notes)
+    return result
+
+
+def validate_batch(
+    addresses: list[str], *, check_smtp: bool = False, timeout_seconds: float = 10.0
+) -> list[dict[str, Any]]:
+    """Validate a deliberately small batch while preserving the caller's order."""
+    if len(addresses) > MAX_BATCH_SIZE:
+        raise ValueError(f"A batch can contain at most {MAX_BATCH_SIZE} addresses.")
+    return [
+        validate_address(address, check_smtp=check_smtp, timeout_seconds=timeout_seconds)
+        for address in addresses
+    ]