Emailable MCP by usefulapi

Working · 2.2 s

io.usefulapi/emailablev1.8.0 Domain verified

Verify email addresses with Emailable one by one or in batches, and read credits and batch results.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://emailable.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

emailable_create_batch Destructive

SPENDS CREDITS: starts a bulk verification of up to 5000 email addresses. Emailable takes 1 credit per email when the batch is created, and if the account has too few credits it may charge the account's saved card to buy more. A test_ API key spends nothing. The batch cannot be cancelled here, and the call is never retried: if it fails or times out, check emailable_get_account before trying again, because a retry can charge twice. Returns the batch id; poll it with emailable_get_batch. Emailable's terms allow verification of opt-in subscribers' addresses. POST /v1/batch.

emailsarray, required

The email addresses to verify, 1-5000.

confirmboolean, required

Must be true. It confirms the user agreed to spend 1 credit per email (and a possible card charge for missing credits).

retriesboolean

Retry mail-server answers for accuracy (default true). false is faster but gives more unknown results.

response_fieldsarray

Only these fields in each result (default: all).

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (4)

emailable_create_batch

destructive

Argument	Type	Description
emails*	array	The email addresses to verify, 1-5000.
confirm*	boolean	Must be true. It confirms the user agreed to spend 1 credit per email (and a possible card charge for missing credits).
retries	boolean	Retry mail-server answers for accuracy (default true). false is faster but gives more unknown results.
response_fields	array	Only these fields in each result (default: all).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "emails",
    "confirm"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[^\\s@,;<>\"]+@[^\\s@,;<>\"']+\\.[^\\s@,;<>\"']+$",
        "maxLength": 320,
        "minLength": 3
      },
      "maxItems": 5000,
      "minItems": 1,
      "description": "The email addresses to verify, 1-5000."
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. It confirms the user agreed to spend 1 credit per email (and a possible card charge for missing credits)."
    },
    "retries": {
      "type": "boolean",
      "description": "Retry mail-server answers for accuracy (default true). false is faster but gives more unknown results."
    },
    "response_fields": {
      "type": "array",
      "items": {
        "enum": [
          "accept_all",
          "birth_year",
          "did_you_mean",
          "disposable",
          "domain",
          "email",
          "first_name",
          "free",
          "full_name",
          "gender",
          "last_name",
          "mailbox_full",
          "mx_record",
          "no_reply",
          "reason",
          "role",
          "score",
          "smtp_provider",
          "state",
          "tag",
          "user"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these fields in each result (default: all)."
    }
  }
}

emailable_get_account

The Emailable account behind this API key: the owner's email and available_credits. Check it before a large batch. GET /v1/account.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

emailable_get_batch

Status and results of a batch made with emailable_create_batch: message, progress (processed/total), reason_counts and total_counts (deliverable, undeliverable, risky, unknown). Batches of up to 1,000 emails also return the results inline in `emails` (30 days). They come in pages: up to `limit` results, fewer if the reply would get too long; ask for the next page with emails_page.next_offset. A bigger batch returns download_file, a temporary link (5 days) to a ZIP of a CSV: share it only with the account owner. Free to call. GET /v1/batch.

read-only

Argument	Type	Description
id*	string	The batch id.
limit	integer	Most results per call, 1-1000 (default 100). A reply can hold fewer; use emails_page.next_offset for the next page.
offset	integer	First result to return (default 0).
partial	boolean	Include the results so far while the batch is still running (only for batches of up to 1,000 emails).
include_emails	boolean	Include per-email results (default true). false returns the counts only.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The batch id."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Most results per call, 1-1000 (default 100). A reply can hold fewer; use emails_page.next_offset for the next page."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 0,
      "description": "First result to return (default 0)."
    },
    "partial": {
      "type": "boolean",
      "description": "Include the results so far while the batch is still running (only for batches of up to 1,000 emails)."
    },
    "include_emails": {
      "type": "boolean",
      "description": "Include per-email results (default true). false returns the counts only."
    }
  }
}

emailable_verify_email

SPENDS CREDITS: verifies one email address and uses 1 Emailable credit (a test_ API key spends none). Returns state (deliverable, undeliverable, risky, unknown), reason, score (0-100), and flags: disposable, free, role, accept_all, no_reply, mailbox_full, plus did_you_mean (a typo fix), the detected user/domain/tag, mx_record and smtp_provider. A credit is returned for an unknown result. The call is never retried automatically. If the reply is {status: "try_again"}, the check took longer than the timeout: call again with the same email; repeats within 5 minutes are not charged. Emailable's terms allow verification of opt-in subscribers' addresses. GET /v1/verify.

destructive

Argument	Type	Description
smtp	boolean	Run the SMTP step (default true). false is faster but much less accurate.
email*	string	The email address to verify.
timeout	integer	Seconds to wait for the result, 2-10 (default 5).
accept_all	boolean	Run the accept-all check (default false). It slows the reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "email"
  ],
  "properties": {
    "smtp": {
      "type": "boolean",
      "description": "Run the SMTP step (default true). false is faster but much less accurate."
    },
    "email": {
      "type": "string",
      "pattern": "^[^\\s@,;<>\"]+@[^\\s@,;<>\"']+\\.[^\\s@,;<>\"']+$",
      "maxLength": 320,
      "minLength": 3,
      "description": "The email address to verify."
    },
    "timeout": {
      "type": "integer",
      "maximum": 10,
      "minimum": 2,
      "description": "Seconds to wait for the result, 2-10 (default 5)."
    },
    "accept_all": {
      "type": "boolean",
      "description": "Run the accept-all check (default false). It slows the reply."
    }
  }
}