Skip to main content
Glama
notprathap

NoBounce Email Validation MCP Server

by notprathap

NoBounce Email Validation MCP Server (nobounce-mcp)

notprathap/nobounce-mcp MCP server

Official Model Context Protocol (MCP) server for NoBounce Email Validation & Bulk CSV Verification API.

Allows AI assistants (Claude Desktop, Cursor, Windsurf, Cline, etc.) to verify single email addresses and bulk email lists in real time:

  • RFC 5322 Syntax & Domain Check

  • DNS MX Record Lookup

  • 5,000+ Disposable / Temp-Mail Provider Detection

  • Role Account Detection (support@, admin@, sales@)

  • Typo Suggestion (gmial.com -> gmail.com)

  • Optional Deep SMTP Mailbox Handshake

  • Bulk Batch Validation (up to 1,000 emails per call with graceful partial-quota processing)

Get a Free API Key

Grab a free API key (100 free validations/month, no credit card required) at https://nobounceapi.com/register.

Related MCP server: verifox-mcp

Tools Provided

  1. validate_email — Validate a single email address (email, optional smtp_check).

  2. validate_emails_bulk — Validate an array of up to 1,000 email addresses (emails, optional smtp_check).

Quickstart (Claude Desktop / Cursor / Windsurf)

Add to your claude_desktop_config.json or .cursor/mcp.json:

{
  "mcpServers": {
    "nobounce": {
      "command": "npx",
      "args": ["-y", "github:notprathap/nobounce-mcp"],
      "env": {
        "NOBOUNCE_API_KEY": "nb-your-api-key-here"
      }
    }
  }
}

License

MIT — https://nobounceapi.com

Available Tools

2 tools
validate_emailAInspect

Validate a single email address for RFC 5322 syntax, DNS MX records, 5,000+ disposable email providers, role-based accounts (admin@, support@), free email providers, domain typo suggestions, and optional SMTP mailbox handshake.

ParametersJSON Schema
NameRequiredDescriptionDefault
emailYesEmail address to validate (e.g. support@google.com)
api_keyNoOptional override for NOBOUNCE_API_KEY environment variable
smtp_checkNoOptional deep SMTP mailbox handshake check (default: false)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the full burden. It does disclose real behavioral depth (DNS MX lookups, disposable-provider lists, optional SMTP handshake, typo suggestions), which hints at latency and external calls, but it says nothing about API-key/auth requirements, rate limits, or what a result contains  notable gaps for a zero-annotation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence, front-loaded with the verb and resource; every clause conveys a distinct capability. Slightly list-heavy but no wasted filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 3-parameter tool with no annotations and no output schema, the description covers input scope well but omits how to choose between this and validate_emails_bulk, and never indicates what a validation response looks like (valid flag, reason, risk signals)  leaving the result-shape burden unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description reinforces the optional SMTP handshake behavior of smtp_check, but adds no syntax or format detail for email or api_key beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb+resource ("Validate a single email address") with the word "single" implicitly scoping it apart from the validate_emails_bulk sibling, and it enumerates the concrete check categories so the agent knows exactly what is inspected.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied via "a single email address," which suggests the one-at-a-time case versus bulk, but there is no explicit when-to-use statement, no exclusion criteria, and the sibling is never named as the alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

validate_emails_bulkAInspect

Validate up to 1,000 email addresses in a single batch call. Checks syntax, MX records, disposable domains, role accounts, free providers, and typo suggestions with automatic partial-quota handling.

ParametersJSON Schema
NameRequiredDescriptionDefault
emailsYesList of email addresses to validate (up to 1,000 per call)
api_keyNoOptional override for NOBOUNCE_API_KEY environment variable
smtp_checkNoOptional deep SMTP handshake check for each email (default: false)

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It usefully discloses the actual check suite (syntax, MX, disposable, role, free, typo) and mentions 'automatic partial-quota handling,' which is real behavioral context. It still omits cost/rate-limit behavior, partial-failure semantics, and the fact that an api_key override exists, so it is only partially covers the full behavioral profile.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, zero filler, with the batch scope and the check inventory front-loaded. Every clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, so the description would ideally say what a validated result looks like and how quota/partial results surface. It fully covers what gets checked but leaves the return shape and failure semantics unspecified for a 3-parameter tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents emails, api_key, and smtp_check — including the SMTP deep-check flag and its default. The description adds no parameter-level detail beyond what the schema provides, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (validate) and resource (email addresses), plus the batch scale ('up to 1,000 in a single batch call'), which implicitly separates it from the single-address sibling. It stops short of naming validate_email outright, so sibling differentiation is inferential rather than explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'In a single batch call' and the 1,000 cap imply the tool is for bulk work while validate_email handles singles, but no explicit when-to-use/when-not statement or named alternative is given. Usage is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • First observedvalidate_email
    • First observedvalidate_emails_bulk

TDQS

A3.7/5.0

Scored across 2 tools

Disambiguation5/5

The two tools are cleanly separated by scope: validate_email handles one address, validate_emails_bulk handles batches up to 1,000. There is no realistic scenario where an agent could confuse the two, and the naming itself signals the distinction.

Naming Consistency4/5

Both tools use snake_case with the same validate_ verb and the same email/emails noun stem, giving a predictable pattern. The only minor deviation is the plural-plus-'bulk' qualifier on the batch variant, which is still readable and conventional.

Tool Count3/5

Two tools is on the thin side even for a narrow validation service; it is essentially one operation exposed in single and bulk form. The count is defensible for the scope but leaves little surface for account/quota management.

Completeness4/5

Single and bulk validation cover the core domain (syntax, MX, disposable, role, free, typo, SMTP) well. The notable gap is the absence of any quota/credits or account-status tool, despite bulk mentioning 'partial-quota handling' — agents cannot inspect remaining quota before large batches.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to verify email addresses through a multi-signal probabilistic pipeline, returning confidence scores and honest statuses (safe/risky/invalid/unknown) with evidence.
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to verify email deliverability and find business emails via the Verifox API, supporting single and bulk operations.
    6
    55 npm
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides email validation and domain configuration auditing tools for AI assistants, enabling single address checks, bulk list cleaning, SPF verification, and full mail setup grading (A-F) with actionable fixes.
    4
    41 npm
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to verify email addresses in real-time, checking syntax, DNS, MX records, and SMTP handshake, returning verdicts and deliverability scores without sending actual emails.
    -