$ man disposable-email-check
/disposable-email-check(1)
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
utilities
STATUS
● live
NAME
disposable-email-check — disposable email detector / fake email filter / fraud signup defense
SYNOPSIS
POST https://x402.org/v1/disposable-email-check
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Disposable email detector / fake email filter / fraud signup defense. Cross-checks 100k+ disposable domains list. Flags role accounts (admin@, noreply@). Verifies MX record via Cloudflare DoH.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| string | Email address to evaluate (e.g. 'user@mailinator.com'). Only the domain and local-part shape are used; the address is not contacted. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| string | Normalized email address that was checked, lowercased with whitespace trimmed. | |
| local_part | string | Portion before the @ sign, e.g. 'jdoe' from 'jdoe+tag@example.com'. |
| domain | string | Portion after the @ sign, lowercased, e.g. 'mailinator.com'. |
| is_valid_format | boolean | True if the address parses as a syntactically valid RFC 5322 email. |
| is_disposable | boolean | True if the domain matches a known disposable/throwaway email provider in the blocklist. |
| matched_blocklist_domain | string | Exact blocklist entry that matched the email's domain, or empty string if no match. |
| is_explicitly_allowed | boolean | True if the domain is on the allowlist override, bypassing the disposable check. |
| is_role_account | boolean | True if the local part is a generic role address like admin, noreply, support, or info. |
| has_plus_tag | boolean | True if the local part contains a '+' subaddress tag (e.g. 'user+spam@gmail.com'). |
| has_mx_record | boolean | True if the domain has at least one MX record resolvable via Cloudflare DoH. |
| blocklist_size | number | Total number of disposable domains in the blocklist used for this check. |
| source | string | Identifier for the blocklist source or version used, e.g. 'disposable-email-domains'. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/disposable-email-check \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the disposable-email-check tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- emaildisposablevalidationfraud
- methods
- POST
- cluster
- webprobe
- price
- $0.005 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| domain-availability | Domain availability / RDAP lookup / WHOIS replacement / domain registration checker / expiry date lookup. | $0.005 |
| github-stars-history | GitHub stars history / star growth chart / repo popularity over time / trending tracker. | $0.005 |
| link-extract | Link extractor / extract links from URL / list all anchor links / page outlink crawler / scrape outbound links / get hrefs from page. | $0.005 |
| mcp-tools-list | MCP tools-list / Model Context Protocol discovery / list MCP server tools / tools/list JSON-RPC / agent capability discovery / MCP catalo… | $0.005 |
| sitemap-fetch | Sitemap fetcher / sitemap.xml parser / sitemap index resolver / SEO sitemap reader / robots.txt sitemap discovery / website URL inventory. | $0.005 |
| wikipedia | Wikipedia API / encyclopedia lookup. | $0.005 |
| wikipedia-lookup | Wikipedia API / encyclopedia lookup / structured article fetch. | $0.005 |
| homoglyph-check | Homoglyph attack detector / Unicode lookalike scanner. | $0.003 |
SEE ALSO