mcpField
E
email-infra

email-infra

github.com/cold-iqMarketing & growth348 installsUpdated 2w ago
Repository

About email-infra

An agent skill for taking cold email infrastructure from capacity planning through launch monitoring, using ColdIQ's resold Instantly endpoints to manage mailboxes and warmup. It is for teams preparing and checking email accounts before outbound campaigns.

Key features

  1. 01Estimate mailbox and domain requirements
  2. 02Order pre-warmed inboxes or connect owned mailboxes
  3. 03Enable warmup and review analytics
  4. 04Test mailbox health before launch
  5. 05Monitor daily sending metrics

Use cases

  1. 01Plan infrastructure for a cold email volume target
  2. 02Set up mailboxes and warm them before sending
  3. 03Check account health before launch and monitor sending

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cold-iq/coldiq-marketplace-skills --skill email-infra

After installing, type/email-infrain Claude Code to confirm it loaded.

Details

From the project README

Email Infrastructure

Take cold email infrastructure from zero to live: size it, provision mailboxes, warm them up, and verify health — using ColdIQ's resold Instantly account/warmup endpoints (BYOK, free, no ColdIQ credits). Once infra is healthy, hand off to instantly-api for campaigns.

ColdIQ Marketplace Endpoints

TaskMethodPathCreditsEndpoint IDNotes
Order DFY pre-warmed inboxesPOST/v1/instantly/dfy-email-account-ordersfreeinstantly.dfy_orders.createFastest path to live
Check domain availabilityPOST/v1/instantly/dfy-email-account-orders/domains/checkfreeinstantly.dfy_orders.domains_checkBefore buying
List pre-warmed domainsPOST/v1/instantly/dfy-email-account-orders/domains/pre-warmed-up-listfreeinstantly.dfy_orders.domains_prewarmedSkip the 2-3 week warmup
Connect a mailboxPOST/v1/instantly/accountsfreeinstantly.accounts.createBring your own mailbox
List mailboxesGET/v1/instantly/accountsfreeinstantly.accounts.listInventory
Get mailbox healthGET/v1/instantly/accounts/{email}freeinstantly.accounts.getPer-account status
Enable warmupPOST/v1/instantly/accounts/warmup/enablefreeinstantly.accounts.warmup_enableStart 2-3 wks before sending
Disable warmupPOST/v1/instantly/accounts/warmup/disablefreeinstantly.accounts.warmup_disableAvoid once campaigns live
Warmup analyticsPOST/v1/instantly/accounts/warmup-analyticsfreeinstantly.accounts.warmup_analyticsHealth scores
Test account vitalsPOST/v1/instantly/accounts/test/vitalsfreeinstantly.accounts.test_vitalsPre-launch check
Daily account analyticsGET/v1/instantly/accounts/analytics/dailyfreeinstantly.accounts.analytics_dailyMonitor live sending

Critical rules (never break)

  1. Never use your primary domain for cold outreach.
  2. Max 2 mailboxes per domain.
  3. One domain = one workspace (never mix).
  4. Use multiple registrars (no single point of failure).
  5. Warm up 2–3 weeks minimum before sending.
  6. Never disable warmup once campaigns are running.
  7. Start conservative, scale gradually.

Infrastructure sizing formula

  • Monthly goal ÷ 20 working days = daily volume
  • Daily volume ÷ 20–25 per mailbox = mailboxes needed
  • Mailboxes × 1.5 (buffer) ÷ 2 = domains needed
  • Provider split: 60% Google Workspace, 40% Microsoft 365

Example: 3,000/month → 150/day → 10–12 mailboxes → 5–6 domains.

DNS — all 4 records required

RecordPurpose
MXRoutes incoming email
SPFDeclares sending servers
DKIMDigital signature authentication
DMARCPolicy for SPF/DKIM failures

(DNS is configured at the registrar/provider — ColdIQ doesn't set DNS. Use the DFY order to skip manual setup.)

Setup flow

  1. Size the infra (formula above).
  2. Fastest path — order done-for-you pre-warmed inboxes (skip manual domain/DNS/warmup). → POST /v1/instantly/dfy-email-account-orders · free · instantly.dfy_orders.create
    • First check what's available: → POST /v1/instantly/dfy-email-account-orders/domains/pre-warmed-up-list · free · instantly.dfy_orders.domains_prewarmed → POST /v1/instantly/dfy-email-account-orders/domains/check · free · instantly.dfy_orders.domains_check
  3. BYO path — connect your own mailboxes, then enable warmup 2–3 weeks before sending. → POST /v1/instantly/accounts · free · instantly.accounts.create → POST /v1/instantly/accounts/warmup/enable · free · instantly.accounts.warmup_enable
  4. Before launch, confirm health. → POST /v1/instantly/accounts/warmup-analytics · free · instantly.accounts.warmup_analytics → POST /v1/instantly/accounts/test/vitals · free · instantly.accounts.test_vitals
  5. Go live (ramp), then monitor daily. → GET /v1/instantly/accounts/analytics/daily · free · instantly.accounts.analytics_daily

Warmup & ramp

Warmup: Week 1 foundation (no campaigns) · Week 2 building (no campaigns) · Week 3 ready (health 70%+, ideally 90%+). Going-live ramp/mailbox: Wk1 G 10–15 / MS 5–10 → Wk2–3 G 15–20 / MS 10–12 → Wk4+ G 20–25 / MS 12–15.

Healthy metrics

Open 50%+ · reply 2%+ · bounce <3% (target <2%) · spam <0.1% · deliverability >95%. If bounce climbs or vitals drop, pause that mailbox and re-check warmup analytics before resuming.

Comments

Markdown supported