Emaileck MCP Server

Official Model Context Protocol server for Emaileck. It lets AI agents manage cold outreach infrastructure through the Emaileck API:

• Find and buy outreach-friendly domains.
• Manage live Name.com DNS records.
• Provision hosted inboxes.
• Connect SMTP/IMAP providers.
• Read and send email through authenticated inboxes.

The default backend is:

https://api.emaileck.com

Install

Run directly with npm:

npx emaileck-mcp-server

Or install globally:

npm install -g emaileck-mcp-server
emaileck-mcp

Configuration

Authenticated tools require an Emaileck bearer token.

export EMAILECK_API_TOKEN="your_emaileck_token"

Optional environment variables:

| Variable | Default | Description | | --- | --- | --- | | EMAILECK_API_TOKEN | none | Bearer token used for authenticated Emaileck API calls. | | EMAILECK_AUTH_TOKEN | none | Backward-compatible token variable. Used if EMAILECK_API_TOKEN is absent. | | EMAILECK_TOKEN | none | Short alias. Used if the two variables above are absent. | | EMAILECK_API_URL | https://api.emaileck.com | Override the backend URL for staging or local development. | | VITE_API_URL | none | Backward-compatible API URL variable. Used if EMAILECK_API_URL is absent. |

Local development example:

EMAILECK_API_URL="https://api.emaileck.com" \
EMAILECK_API_TOKEN="your_local_token" \
node server.js

Claude Desktop

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "emaileck": {
      "command": "npx",
      "args": ["-y", "emaileck-mcp-server"],
      "env": {
        "EMAILECK_API_TOKEN": "your_emaileck_token"
      }
    }
  }
}

For staging or local development, add EMAILECK_API_URL:

{
  "mcpServers": {
    "emaileck-local": {
      "command": "node",
      "args": ["/absolute/path/to/emaileck-ai/mcp/server.js"],
      "env": {
        "EMAILECK_API_URL": "https://api.emaileck.com",
        "EMAILECK_API_TOKEN": "your_local_token"
      }
    }
  }
}

Tools

Domains

| Tool | Auth | Description | | --- | --- | --- | | get_domain_ideas | yes | Suggest lookalike cold outreach domains with availability and prices. | | check_domain_availability | no | Check availability and prices for a list of domains. | | create_domain_payment_intent | yes | Create a Stripe PaymentIntent for domain registration. | | provision_paid_domains | yes | Provision domains after a PaymentIntent succeeds. | | purchase_domains_with_credits | yes | Purchase and provision domains using wallet credits. | | replace_domain | yes | Mark an old domain inactive and provision a replacement. | | get_list_of_domains | yes | List the authenticated account's domains. |

DNS

| Tool | Auth | Description | | --- | --- | --- | | list_dns_records | yes | List live Name.com DNS records for an owned domain. | | create_dns_records | yes | Create Name.com DNS records. | | update_dns_record | yes | Update a DNS record by Name.com record id. Updates are full overwrites. | | delete_dns_record | yes | Delete a DNS record by Name.com record id. | | verify_authentication | no | Resolve public MX, SPF, DKIM, and DMARC records. |

Inboxes and Email

| Tool | Auth | Description | | --- | --- | --- | | suggest_inbox_names | no | Suggest mailbox usernames from a person and domain. | | create_mailbox | yes | Provision one hosted mailbox. | | create_list_of_inboxes | yes | Provision multiple hosted mailboxes. | | connect_provider | yes | Connect an external SMTP/IMAP inbox. | | test_inbox_connection | yes | Test SMTP and IMAP connectivity. | | get_list_of_inboxes | yes | List inboxes. | | receive_emails | yes | Read recent messages from an inbox. | | send_email | yes | Send an email from an inbox. | | pause_inbox | yes | Pause or resume an inbox. |

Backward-compatible aliases are also exposed:

• configure_dns -> create_dns_records
• create_mailboxes -> create_mailbox
• send_emails -> send_email

Example Prompts

Find 10 available cold outreach domains similar to example.com.

List DNS records for brandoutreach.com and add a TXT record for DMARC.

Create inboxes [email protected] and [email protected].

Send a test email from inbox 12 to [email protected].

Safety Notes

Several tools mutate paid or production resources:

• purchase_domains_with_credits spends wallet credits.
• create_domain_payment_intent creates a Stripe payment flow.
• create_dns_records, update_dns_record, and delete_dns_record change live Name.com DNS.
• create_mailbox and create_list_of_inboxes provision mailboxes.
• send_email sends real email.

MCP clients should ask for user confirmation before calling tools that spend money, mutate DNS, provision mailboxes, or send email.

REST API

The MCP server wraps the Emaileck REST API. See API.md for endpoint documentation, request payloads, and examples.

Publishing

From the mcp directory:

npm login
npm pack --dry-run
npm publish

If the package name is unavailable on npm, update the name field in package.json before publishing.