# Cold Mail Marketing

AI-powered cold email campaign management through Model Context Protocol (MCP).

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mailgo/cold-mail-marketing

# Browse available tools
npx -y @smithery/cli@latest tool list mailgo/cold-mail-marketing

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mailgo/cold-mail-marketing verify_emails

# Call a tool
npx -y @smithery/cli@latest tool call mailgo/cold-mail-marketing verify_emails '{}'
```

## Direct MCP Connection

Endpoint: `https://cold-mail-marketing--mailgo.run.tools`

**Required config:**
- `x-api-key` (header) — Your Mailgo API token. Get it at https://app.mailgo.ai → Profile → Personal Tokens → Create Token.

## Tools (5)

- `verify_emails` — Verify a list of email addresses for deliverability. Submits up to 1000 addresses in one batch and returns them categor…
- `claim_free_mailbox` — Claim a free pre-warmed sending mailbox from Mailgo (60-day validity, sender score 90+). Useful for getting started wit…
- `create_campaign` — Create a fully personalised cold email campaign in one step: upload HTML content, create the campaign with schedule and…
- `campaign_control` — Control campaign lifecycle: activate, pause, delete, list all campaigns, or get full details of a specific campaign.
- `campaign_report` — Get campaign statistics and reports. Supports four report types: overview (totals + rates), rounds (per-sequence-round …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mailgo/cold-mail-marketing <tool-name>
```