WarmInboxes Free MCP: Fleet Planner
Read-only sizing and pricing for cold email inboxes: how many, which provider, what it costs.
Should I use this
Quality & Safety
Findings (2)
- HIGH
- MEDIUMin find_resources
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"fleet-planner": {
"url": "https://warminboxes.com/mcp/planner"
}
}
}Remote endpoints
https://warminboxes.com/mcp/plannerstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢check_domain_expiry(domain)
Get a domain's registrar, creation date, expiry date and days remaining, over RDAP with a WHOIS fallback for ccTLDs that publish no RDAP service. Domain age is useful context when diagnosing deliverability, read alongside the provider, reputation and sending history; no published WarmInboxes study isolates its effect.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain to look up, e.g. \"acme.com\"."
}
},
"required": [
"domain"
],
"additionalProperties": false
}🟢check_google_domain(domain)
Tell whether a domain is already attached to a Google Workspace account, or is clear for a fresh Google tenant.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain to check, e.g. \"acme.com\"."
}
},
"required": [
"domain"
],
"additionalProperties": false
}🟢lookup_mx(domain, domains)
Look up a domain's MX records with priorities and resolved IPs, and identify the mailbox provider (Google Workspace, Microsoft 365, Zoho, Fastmail and others) and any security gateway in front of it (Mimecast, Proofpoint, Barracuda and others). Pass `domains` instead of `domain` for up to 100 at once, which also returns a provider breakdown. Reports a null MX (RFC 7505) rather than treating it as a broken record, and does not guess the provider behind a gateway, because that is not observable from the MX.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "A single domain, e.g. \"acme.com\". An address like \"[email protected]\" is accepted."
},
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 100 domains, instead of `domain`."
}
},
"required": [],
"additionalProperties": false
}🟢segment_esp(domains)
Split a list of domains by the email provider behind them (Google, Microsoft, a security gateway, or another provider) from their MX records. WarmInboxes routes Google-hosted recipients to Google Workspace inboxes and everyone else to Azure; plan_from_list sizes that split.
Input Schema
{
"type": "object",
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Domains to segment."
}
},
"required": [
"domains"
],
"additionalProperties": false
}🟢plan_from_list(domains, emailsPerDay, prewarmed, microsoftEsp, billing, ...)
Estimates a sending fleet for a recipient list. Looks up the MX records of up to 100 recipient domains (or addresses) to measure the provider mix, then sizes a Google Workspace pool for the Google-hosted recipients and an Azure pool for everyone else (Microsoft 365, other providers and gateway-protected domains, with a warning for gateways); microsoftEsp: "microsoft" moves the Microsoft recipients to a Microsoft 365 pool, only when the person asks for it. Returns inbox count, domain count, per-inbox pace and monthly cost for each pool, plus totals, the routing rule and the placement-log figures behind it. Domains with no mail server are left out and named. For a longer list, send a sample: the estimate follows the provider split, not the list length. Assumes no reserve capacity. A planning estimate only: it does not provision or order anything. The result describes how an order is placed: a first order in the WarmInboxes app, later ones through WarmInboxes Infrastructure MCP.
Input Schema
{
"type": "object",
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 100 recipient domains or email addresses. Deduplicated."
},
"emailsPerDay": {
"type": "number",
"description": "Target cold emails per day across the whole list, e.g. 1500."
},
"prewarmed": {
"type": "boolean",
"description": "true for prewarmed inboxes (sending within 48–72 hours of delivery), false for fresh (21-day warmup, cheaper). Defaults to true."
},
"microsoftEsp": {
"type": "string",
"enum": [
"azure",
"microsoft"
],
"description": "Which pool carries the Microsoft recipients. Defaults to azure; use microsoft only when the person asks for Microsoft 365 inboxes."
},
"billing": {
"type": "string",
"enum": [
"monthly",
"twoMonth",
"quarterly"
],
"description": "Prewarmed commitment length. Longer is cheaper. Defaults to monthly."
},
"rotation": {
"type": "boolean",
"description": "Rest half the fleet at any moment, which doubles the inboxes bought. Defaults to false."
}
},
"required": [
"domains",
"emailsPerDay"
],
"additionalProperties": false
}🟢plan_infrastructure(emailsPerDay, esp, prewarmed, billing, emailsPerMailbox, ...)
Estimates how many inboxes and domains a daily cold email volume needs and the monthly cost at WarmInboxes' published prices. Inputs: emailsPerDay; optionally the provider (esp), prewarmed or fresh, billing cycle, emails per inbox per day and inboxes per domain. With currentInboxes (healthy inboxes already sending) it sizes only the shortfall between their capacity and the target, and says when nothing needs adding; with reservePercent it adds that much spare capacity on top, and only when asked: no reserve is recommended by default. With dealValue (and optionally closeRate and positiveRate) it adds a revenue and ROI projection from those inputs. Assumes the provider's default daily pace per inbox unless emailsPerMailbox is given, and 22 sending days a month. The result is a planning estimate: it orders nothing, does not guarantee placement or replies, and its revenue figures follow only from the rates supplied.
Input Schema
{
"type": "object",
"properties": {
"emailsPerDay": {
"type": "number",
"description": "Target cold emails per day, e.g. 500."
},
"esp": {
"type": "string",
"enum": [
"google",
"microsoft",
"azure"
],
"description": "Sending platform. Defaults to google."
},
"prewarmed": {
"type": "boolean",
"description": "true for prewarmed inboxes (ready to send on delivery), false for fresh (14-21 day warmup, about a third the price). Defaults to true."
},
"billing": {
"type": "string",
"enum": [
"monthly",
"twoMonth",
"quarterly"
],
"description": "Prewarmed commitment length. Longer cycles are cheaper. Defaults to monthly. Google and Microsoft are billed per inbox; Azure is billed per tenant, flat, whatever is on the tenant."
},
"emailsPerMailbox": {
"type": "number",
"description": "Daily sends per inbox. Defaults to the platform's safe pace: 15 Google, 8 Microsoft, 2 Azure."
},
"mailboxesPerDomain": {
"type": "number",
"description": "Fresh Google and Microsoft only. Defaults to 3."
},
"inboxesPerTenant": {
"type": "number",
"enum": [
25,
50,
100
],
"description": "Fresh Azure only: how densely a tenant is packed. Also sets the pace, since a lighter tenant sends more per inbox (25/6, 50/4, 100/2). Defaults to 100."
},
"rotation": {
"type": "boolean",
"description": "Rest half the fleet at any moment, which doubles the inboxes bought. Defaults to false."
},
"currentInboxes": {
"type": "number",
"description": "Healthy inboxes already sending on this platform. When given, only the shortfall between their capacity and emailsPerDay is sized."
},
"reservePercent": {
"type": "number",
"description": "Spare capacity to add on top of the target, 0 to 100, only when the person asks for a reserve. Defaults to 0."
},
"dealValue": {
"type": "number",
"description": "Average deal size. Supply it to get replies, deals, revenue and ROI."
},
"closeRate": {
"type": "number",
"description": "Percent of positive replies that close. Defaults to 10."
},
"positiveRate": {
"type": "number",
"description": "Percent of sends that reply positively. Defaults to 1."
}
},
"required": [
"emailsPerDay"
],
"additionalProperties": false
}🟢quote_inboxes(inboxes, provider, prewarmed, billing)
Prices a given number of inboxes at WarmInboxes' published prices: the domains (or Azure tenants) they sit on, daily sending capacity at the provider's pace, monthly cost and delivery time. Use it when the person already knows the count ("preview 100 inboxes"); for a send volume use plan_infrastructure. Azure is sold by the tenant, so a count that does not fill one is quoted for the tenants it needs, with a note. A quote only: it orders nothing, and the exact preview with real domain and mailbox names is in the app or on WarmInboxes Infrastructure MCP.
Input Schema
{
"type": "object",
"properties": {
"inboxes": {
"type": "number",
"description": "How many inboxes, 1 to 20,000."
},
"provider": {
"type": "string",
"enum": [
"google",
"microsoft",
"azure"
],
"description": "Google Workspace, Microsoft 365, or Azure (Microsoft tenants). Defaults to google."
},
"prewarmed": {
"type": "boolean",
"description": "true for prewarmed inboxes, false for fresh (14-21 day warmup, cheaper). Defaults to true."
},
"billing": {
"type": "string",
"enum": [
"monthly",
"twoMonth",
"quarterly"
],
"description": "Prewarmed commitment length. Longer is cheaper. Defaults to monthly."
}
},
"required": [
"inboxes"
],
"additionalProperties": false
}🟢get_diagnostic_playbook(symptom, scenario)
Returns WarmInboxes' diagnostic playbook for a cold email problem: the questions to ask the person, the checks to run in order from cheapest to most expensive (with the tool for each), what WarmInboxes' published studies measured a finding to cost (for example that a SURBL listing left reply rate flat, while Google's domain-reputation refusal cost about 43% of replies), the guides and studies to read with full URLs, the evidence that would make new domains or inboxes the right fix, and WarmInboxes' operator notes that bear on it. Give a symptom in the person's words, or a scenario id; with neither it lists the scenarios. Runs no check on any domain.
Input Schema
{
"type": "object",
"properties": {
"symptom": {
"type": "string",
"description": "The problem in the person's words, e.g. \"reply rate dropped by half this month\" or \"my domain is listed on SURBL\"."
},
"scenario": {
"type": "string",
"enum": [
"reply-rate-drop",
"blocklist-listing",
"outlook-junk",
"gmail-spam",
"bounces-rising",
"am-i-burned",
"new-setup",
"scaling"
],
"description": "A scenario id, when the problem is already known."
}
},
"required": [],
"additionalProperties": false
}🟢generate_dns_records(spfProviders, spfIncludes, spfMx, spfAll, dmarcPolicy, ...)
Write an SPF record from the providers that send for a domain (with an estimate of its DNS lookups against the limit of 10), a DMARC record from a policy, and where a provider publishes DKIM. Returns host, type and value to publish. It writes records; to check what is published, use check_spf, check_dmarc and check_dkim.
Input Schema
{
"type": "object",
"properties": {
"spfProviders": {
"type": "array",
"items": {
"type": "string"
},
"description": "Providers that send for the domain, e.g. [\"Google Workspace\", \"SendGrid\"]."
},
"spfIncludes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Extra SPF include domains, e.g. [\"_spf.example.com\"]."
},
"spfMx": {
"type": "boolean",
"description": "Add the mx mechanism. Defaults to false."
},
"spfAll": {
"type": "string",
"enum": [
"-all",
"~all",
"?all"
],
"description": "Policy for unlisted senders. Defaults to ~all."
},
"dmarcPolicy": {
"type": "string",
"enum": [
"none",
"quarantine",
"reject"
],
"description": "Ask for a DMARC record with this policy. p=none is fine for cold email."
},
"dmarcRua": {
"type": "string",
"description": "Address for aggregate reports, e.g. [email protected]."
},
"dmarcPct": {
"type": "string",
"enum": [
"100",
"50",
"25",
"10"
],
"description": "Percentage the policy applies to. Defaults to 100."
},
"dmarcSubdomainPolicy": {
"type": "string",
"enum": [
"none",
"quarantine",
"reject"
],
"description": "Subdomain policy, if different."
},
"dkimProvider": {
"type": "string",
"description": "A provider to get DKIM setup steps for, e.g. \"Google Workspace\"."
}
},
"required": [],
"additionalProperties": false
}🟢plan_rotation(sendsPerDay, inboxes, sequenceDays, cadenceWeeks)
Builds a warm rotation, WarmInboxes' method: the inboxes split into Batch 1 and Batch 2, both tagged in the sequencer and added to the campaign, the active batch at full daily limits while the resting batch sends follow-ups only, swapped by changing the limits on each tag. The swap cycle follows the sequence length (sequenceDays: up to 7 days weekly, up to 14 every two weeks, longer monthly). Returns batch sizes, the cycle and why, the setup steps, how to rotate lead lists between the batches, the daily load per active inbox against a 15-a-day pace, how many inboxes the volume needs, and an eight-week calendar. Use it for anyone asking how to rotate inboxes, keep inboxes and domains alive longer, or send into saturated niches such as ecommerce, SaaS or healthcare. A suggested plan only: it changes no inbox or sequencer.
Input Schema
{
"type": "object",
"properties": {
"sendsPerDay": {
"type": "number",
"description": "Cold emails sent per day."
},
"inboxes": {
"type": "number",
"description": "Inboxes in the fleet."
},
"sequenceDays": {
"type": "number",
"description": "Days from the first step of the sequence to the last. Sets the swap cycle: up to 7 weekly, up to 14 every two weeks, longer monthly."
},
"cadenceWeeks": {
"type": "number",
"enum": [
1,
2,
4
],
"description": "Weeks between swaps, to override the cycle sequenceDays sets. Defaults to 2 when neither is given."
}
},
"required": [
"sendsPerDay",
"inboxes"
],
"additionalProperties": false
}🟢plan_verification_waterfall(listSize, verifiers)
Price an email verification waterfall: the list run through verifiers in sequence with unknowns passed down the chain, every order compared, cheapest cost per usable email first. Uses typical figures for three verifiers unless you pass your own prices and resolve rates (POST JSON for verifiers).
Input Schema
{
"type": "object",
"properties": {
"listSize": {
"type": "number",
"description": "Emails on the list."
},
"verifiers": {
"type": "array",
"description": "Optional: up to 5 verifiers with pricePer1k (USD), resolvePct (share given a definite answer) and validOfResolvedPct (share of those that are valid).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"pricePer1k": {
"type": "number"
},
"resolvePct": {
"type": "number"
},
"validOfResolvedPct": {
"type": "number"
}
},
"required": [
"pricePer1k",
"resolvePct",
"validOfResolvedPct"
]
}
}
},
"required": [
"listSize"
],
"additionalProperties": false
}🟢convert_csv(csv, platform)
Rename a lead CSV's columns to the fields a sequencer imports (Instantly, Smartlead, EmailBison, or generic snake_case). Every row and column is kept; only the header changes, and columns with no standard field keep a snake_case name for custom variables. Returns the mapping, and the converted CSV when it is 500 rows or fewer.
Input Schema
{
"type": "object",
"properties": {
"csv": {
"type": "string",
"description": "The lead CSV as text, header row first."
},
"platform": {
"type": "string",
"enum": [
"instantly",
"smartlead",
"emailbison",
"generic"
],
"description": "The sequencer to import into."
}
},
"required": [
"csv",
"platform"
],
"additionalProperties": false
}🟢find_tools(task, callableOnly, limit)
Find the WarmInboxes free tool for a task ("check my email headers", "clean a CSV", "will this land in spam") and say how to use it: the MCP tool to call here, or the page to send the person to when it runs only in the browser. Call with no task to list every tool.
Input Schema
{
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "The job, in plain words, e.g. \"find which DKIM selectors a domain uses\"."
},
"callableOnly": {
"type": "boolean",
"description": "Only tools you can call from this server. Defaults to false."
},
"limit": {
"type": "number",
"description": "How many matches, 1 to 10. Defaults to 5."
}
},
"required": [],
"additionalProperties": false
}🟢find_resources(query, type, limit)
Search what WarmInboxes publishes: operator notes (WarmInboxes' rules from running fleets, with the research behind them), cold email guides, deliverability playbooks, original studies and their datasets, costed infrastructure recipes, tool demo videos, inbox guides per sequencer and AI agent, provider comparisons, Claude skills, the changelog, the product pages (the ChatGPT plugin, the Claude connector, the MCP servers, the platform features, each with its current status), and the offer and about pages. Searches titles and full text, and each match carries the passage that best answers the query. It holds WarmInboxes' own studies as well as guides: 5 published studies, each with a stable WI-RESEARCH ID; type "study" lists every one, and https://warminboxes.com/research.json is the index. read_resource returns a whole page.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "A question or topic, e.g. \"warming up Azure inboxes\" or \"Smartlead\"."
},
"type": {
"type": "string",
"enum": [
"note",
"plugin",
"feature",
"guide",
"playbook",
"study",
"dataset",
"recipe",
"video",
"inbox-guide",
"comparison",
"skill",
"changelog",
"company"
],
"description": "Optional: only this kind of resource."
},
"limit": {
"type": "number",
"description": "How many matches, 1 to 10. Defaults to 5."
}
},
"required": [],
"additionalProperties": false
}🟢read_resource(url, part)
Read a WarmInboxes operator note, guide, study, playbook, dataset, recipe, comparison or changelog entry in full, as markdown. Long pages come in parts split at headings: the first call says how many, and nextPart gives the one to ask for. Datasets also return their data as JSON. Use the url find_resources gave you.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The page, as find_resources returned it, e.g. \"https://warminboxes.com/research/inbox-placement-log\", or a note as \"note:<id>\". A path works too."
},
"part": {
"type": "number",
"description": "Which part of a long page, from 1. Defaults to 1."
}
},
"required": [
"url"
],
"additionalProperties": false
}🟢get_pricing
The WarmInboxes price list as data: prewarmed and fresh inboxes on Google Workspace, Microsoft 365 and Azure, every billing cycle, the safe daily send pace per inbox, and delivery time. For a costed fleet for a volume, use plan_infrastructure.
Input Schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Community
Evidence