Isitdisposable Mcp

io.github.richeloPublished by GitHub account richelov0.1.1Updated Oct 24, 2026

An MCP server that lets AI agents check whether an email address or domain is disposable.

VerifiedSTDIODesktop onlyCommunication & CollaborationSecurity & Monitoring

Overview

AI-generated overview

A local MCP server that lets an assistant check whether an email address or domain is disposable, using the isitdisposable.com API.

What you can do
Check a single email address for a disposable or throwaway inbox verdict and recommended action (allow, warn or block). Check a single bare domain the same way. Check up to 100 mixed addresses and domains in one batch call. Read optional signals such as mail server validity, relay or catch-all addresses, public free providers and typo suggestions.
When to use it
Useful when an assistant handles signups, lead lists or contact data and needs a quick disposable-email or domain verdict before allowing, warning on or blocking an address. Best for single checks or batches of up to 100 items.
Requirements
Runs locally as an npm package, normally via npx, so Node.js is needed. Requires an isitdisposable.com API key set in the ISITDISPOSABLE_API_KEY environment variable; a free tier is available. Network access to the isitdisposable.com API is needed for each check.
Before you install
The API key is a secret sent with every check; keep it out of shared configuration. Addresses and domains you check are sent to the third-party isitdisposable.com service. The server fails open: on network errors, timeouts, rate limits or server errors it returns disposable null and action allow with checked false, which must be treated as inconclusive rather than safe.

Installation

In SourceWeft

  1. Open Isitdisposable Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

json
{  "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

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

ToolWhat it does
check_emailChecks a single email address to see whether it is disposable.
check_domainChecks a single bare domain (no local part) to see whether it is disposable.
check_batchChecks 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.

Source: README.md at commit cb3b562

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts