Skip to main content
Glama
isitdisposable-mcp

isitdisposable-mcp

by richelo

isitdisposable-mcp

A Model Context Protocol (MCP) server that lets an AI agent check whether an email address or domain is disposable, using the isitdisposable.com application programming interface (API).

Installation

The server is published to the npm registry and is normally run with npx, so there is nothing to install by hand; the examples below show how to wire it into a Model Context Protocol (MCP) host.

Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "isitdisposable": {
      "command": "npx",
      "args": ["-y", "isitdisposable-mcp"],
      "env": { "ISITDISPOSABLE_API_KEY": "your_secret_key" }
    }
  }
}

Claude Code

claude mcp add isitdisposable --env ISITDISPOSABLE_API_KEY=your_secret_key -- npx -y isitdisposable-mcp

Related MCP server: mcp-email-sender

Getting an API key

An isitdisposable.com key is required. Get a free key at https://isitdisposable.com (a free tier is available), then set it as ISITDISPOSABLE_API_KEY in the configuration above.

Tools

Tool

What it does

check_email

Checks a single email address to see whether it is disposable.

check_domain

Checks a single bare domain (no local part) to see whether it is disposable.

check_batch

Checks up to 100 email addresses or bare domains at once in a single call. Mix full addresses and bare domains freely in the items list; entries containing an @ sign are sent as email addresses, everything else as a domain.

Every tool returns the same verdict shape. disposable is the core true or false verdict: a disposable address is a throwaway or temporary inbox used to receive a single signup message and evade normal registration requirements, rather than a real, ongoing mailbox. action is the recommended handling of allow, warn, or block. A handful of opt in signals may also be present, including mx_valid (whether the domain's mail servers accept mail), relay (a forwarding or catch all style address), public_domain (a well known free provider such as Gmail), and did_you_mean (a likely intended domain when the one given looks like a typo).

Fail open behavior

This server always fails open. If a network problem, a timeout, a rate limit, or a server error prevents a real check from completing, the tool call still succeeds (it never throws or crashes the connection). It retries once after a short delay, and if that also fails, it returns a result with checked: false, disposable: null, and action: "allow", along with a note explaining that the check could not be completed. An agent using this tool should treat that outcome as inconclusive, not as a signal that the address is safe.

If no API key is configured, the server still starts normally and responds to the Model Context Protocol (MCP) handshake; each tool call then returns an error result pointing to https://isitdisposable.com to get a free key.

Available Tools

3 tools
check_batchCheck a batch of emails and domains for disposableA
Read-only

Checks up to 100 email addresses or domains at once in a single call, which is far more efficient than calling the single-item tools in a loop. Provide a mixed list in items: entries containing an @ sign are sent as email addresses, and all other entries are sent as bare domains. A disposable address is a throwaway or temporary inbox (for example from a burner mail service) that someone uses to receive a single signup message and evade normal registration requirements, rather than a real, ongoing mailbox. In the response, disposable is the core true or false verdict. action is the recommended handling: allow, warn, or block, based on the caller's own account policy. Extra opt in signals may also be present: mx_valid (whether the domain's mail servers accept mail at all), relay (a forwarding or catch all style address rather than a dedicated inbox), public_domain (a well known free provider such as Gmail or Outlook), and did_you_mean (a likely intended domain when the one given looks like a typo). This tool always fails open: if a network problem, timeout, rate limit, or server error prevents a real check, the call still succeeds and returns checked false with action allow, plus a note explaining the check could not be completed. Treat that outcome as inconclusive, never as evidence the address is safe.

Inputs: items (required).

check_domainCheck domain for disposableA
Read-only

Checks a single bare domain (no local part, for example when only a company's domain is known and not a specific address) to see whether it is disposable. A disposable address is a throwaway or temporary inbox (for example from a burner mail service) that someone uses to receive a single signup message and evade normal registration requirements, rather than a real, ongoing mailbox. In the response, disposable is the core true or false verdict. action is the recommended handling: allow, warn, or block, based on the caller's own account policy. Extra opt in signals may also be present: mx_valid (whether the domain's mail servers accept mail at all), relay (a forwarding or catch all style address rather than a dedicated inbox), public_domain (a well known free provider such as Gmail or Outlook), and did_you_mean (a likely intended domain when the one given looks like a typo). This tool always fails open: if a network problem, timeout, rate limit, or server error prevents a real check, the call still succeeds and returns checked false with action allow, plus a note explaining the check could not be completed. Treat that outcome as inconclusive, never as evidence the address is safe.

Inputs: domain (required).

check_emailCheck email for disposableA
Read-only

Checks a single email address to see whether it is disposable. A disposable address is a throwaway or temporary inbox (for example from a burner mail service) that someone uses to receive a single signup message and evade normal registration requirements, rather than a real, ongoing mailbox. In the response, disposable is the core true or false verdict. action is the recommended handling: allow, warn, or block, based on the caller's own account policy. Extra opt in signals may also be present: mx_valid (whether the domain's mail servers accept mail at all), relay (a forwarding or catch all style address rather than a dedicated inbox), public_domain (a well known free provider such as Gmail or Outlook), and did_you_mean (a likely intended domain when the one given looks like a typo). This tool always fails open: if a network problem, timeout, rate limit, or server error prevents a real check, the call still succeeds and returns checked false with action allow, plus a note explaining the check could not be completed. Treat that outcome as inconclusive, never as evidence the address is safe.

Inputs: email (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.7/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: check_email handles full addresses, check_domain handles bare domains, and check_batch handles mixed lists. While check_batch overlaps in capability, the single vs. batch distinction is explicit and unambiguous.

    Naming Consistency5/5

    All tool names follow the same check_ prefix followed by a noun (email, domain, batch), creating a predictable and consistent verb-noun pattern.

    Tool Count5/5

    Three tools are well-scoped for this service: single email, single domain, and batch. This covers the core use cases without bloat or unnecessary additions.

    Completeness5/5

    The tool surface fully covers the domain of disposable address checking: individual emails, individual domains, and batch processing. No obvious missing operations for a read-only verification service.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for disposable email — create inboxes, receive emails, and extract OTP codes. Let your AI agent sign up for services, wait for verification emails, and extract codes autonomously.
      7
      51 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that enables AI agents to validate email addresses and send emails via SMTP with zero external dependencies.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Disposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.
      39
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that exposes a verify_email tool for checking email syntax, disposable domains, and MX records, returning a structured validity result.
      1
      ISC