Skip to main content
Glama
ContactLint MCP server

ContactLint MCP server

by zksyncer

ContactLint MCP Server (contactlint-mcp)

ContactLint checks email addresses and phone numbers before your AI agent saves or uses them. You can run it as a local stdio MCP server (contactlint-mcp, reading CONTACTLINT_API_KEY from the environment) or connect directly to the hosted Streamable HTTP endpoint (https://contactlint.com/mcp).

Tools

Tool

Input

What it does

validate_email

email

Checks syntax, MX and A records over DNS-over-HTTPS, known disposable domains, role addresses (admin@, no-reply@) and free providers, and suggests a fix when the domain looks like a typo of a major provider (gmial.com).

validate_emails

emails (1 to 50 addresses)

Same checks as validate_email for up to 50 addresses in one call. Returns one result per address in the same order plus a summary of verdicts.

validate_phone

phone, optional country (ISO 3166-1 alpha-2 default region, for example US)

Parses and validates a phone number: valid and possible flags, line type, region, E.164, national and international formats.

ContactLint does not connect to mail servers (no SMTP probing), so it cannot confirm that a mailbox exists or detect catch-all domains.

initialize and tools/list work without a key, so clients and directory scanners can read the tool list. tools/call requires a ContactLint API key (100 free checks per month, no card required).

Related MCP server: Email Verifier MCP Server

The local stdio server (bin/contactlint-mcp.mjs) reads your API key from the CONTACTLINT_API_KEY secret environment variable and forwards authenticated tool calls to https://contactlint.com/mcp.

Environment variables

Variable

Required

Secret

Description

CONTACTLINT_API_KEY

Yes

Yes

Your ContactLint API key, sent as Authorization: Bearer <key>. Get a free key (100 checks/month, no card) at https://contactlint.com/signup

CONTACTLINT_MCP_URL

No

No

Optional endpoint override (defaults to https://contactlint.com/mcp)

Client configuration (stdio via npx)

{
  "mcpServers": {
    "contactlint": {
      "command": "npx",
      "args": ["-y", "github:zksyncer/contactlint"],
      "env": {
        "CONTACTLINT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Or when installed locally (npm install -g github:zksyncer/contactlint or pnpm add contactlint-mcp):

{
  "mcpServers": {
    "contactlint": {
      "command": "contactlint-mcp",
      "env": {
        "CONTACTLINT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Option 2: Hosted Streamable HTTP MCP server

If your MCP client supports custom HTTP headers on remote streamable-http servers, you can connect directly without installing anything:

{
  "mcpServers": {
    "contactlint": {
      "type": "http",
      "url": "https://contactlint.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Billing

  • One check per address or number checked. A validate_emails call with 20 addresses uses 20 checks.

  • Addresses whose DNS lookup fails come back unknown (dns_error) and are not billed.

  • If a key does not have enough checks for a whole validate_emails list, nothing is checked or billed.

  • 100 checks per month are free, no card needed.

  • Credit packs: 5,000 checks for $9, 25,000 for $35, 100,000 for $99.

Free tools

Free browser tools (disposable email checker, phone number validator, disposable domain list) are at https://contactlint.com/tools

License

MIT, see LICENSE.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    C
    maintenance
    Enables agents to verify postal addresses, email addresses, and phone numbers against Melissa's Global Verification APIs before acting on the data, including batch verification and a per-session call budget to prevent runaway costs.
    4
    -
  • 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.
    -
  • A
    license
    A
    quality
    B
    maintenance
    Enables agents to validate and normalize phone numbers, email addresses, and postal addresses with production-grade, country-specific rules, including formatting, typo detection, and checks for disposable domains or fictional numbers.
    3
    1
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables agents to validate email addresses through RFC 5321 syntax checks, MX record lookups, a 182,000-domain disposable blacklist, role-account detection, and an optional SMTP handshake. Runs locally via npx or as a hosted HTTP endpoint, returning explainable per-check scores at zero per-lookup API cost.
    4
    MIT