ai.bobwork/emailwarmup is an MCP server published by ai.bobwork, hosted at app-emailwarmup.bobwork.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 46 tools, including get_account, list_mailboxes, get_mailbox, mailbox_activity, warmup_stats.
Warm up mailboxes, check the ready-for-outbound gate, run cold email and get checkout links.
12 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Your account: email, credit balance, free mailbox allowance (3 on new accounts; older accounts keep 10 or 20; plus referral bonus), paid extras and your referral link.
No parameters.
{
"name": "get_account",
"description": "Your account: email, credit balance, free mailbox allowance (3 on new accounts; older accounts keep 10 or 20; plus referral bonus), paid extras and your referral link.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Every connected mailbox with warm-up day, status, 7-day spam rate, today's and last 7 days' numbers, and whether it is ready for outbound.
No parameters.
{
"name": "list_mailboxes",
"description": "Every connected mailbox with warm-up day, status, 7-day spam rate, today's and last 7 days' numbers, and whether it is ready for outbound.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One mailbox's warm-up status and health.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "get_mailbox",
"description": "One mailbox's warm-up status and health.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The last 100 warm-up events for a mailbox (sent, received, replied, rescued from spam, errors).
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "mailbox_activity",
"description": "The last 100 warm-up events for a mailbox (sent, received, replied, rescued from spam, errors).",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Totals across your mailboxes: today and last 7 days (sent, received, rescued, replied), active and ready counts.
No parameters.
{
"name": "warmup_stats",
"description": "Totals across your mailboxes: today and last 7 days (sent, received, rescued, replied), active and ready counts.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}IMAP/SMTP presets (Gmail app password, Yahoo, iCloud, Zoho, Lark, SES, SendGrid, Mailgun…) with hosts and ports, plus the Google and Zoho API routes.
No parameters.
{
"name": "list_providers",
"description": "IMAP/SMTP presets (Gmail app password, Yahoo, iCloud, Zoho, Lark, SES, SendGrid, Mailgun…) with hosts and ports, plus the Google and Zoho API routes.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Connect any mailbox with IMAP + SMTP. The login is tested before it is saved. Use an app password when two-factor sign-in is on. Give a preset (see list_providers) or the hosts. Warm-up starts the same day.
| Parameter | Type | Description |
|---|---|---|
| host | string | IMAP host (if no preset) |
| name | string | Display name on sent mail |
| port | integer | |
| user | string | Login if not the email |
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
| preset | string | e.g. gmail-imap, yahoo, icloud, zoho, lark, aws-ses, sendgrid, mailgun, other |
| password * | string | Mailbox password or app password |
| smtp_host | string | |
| smtp_port | integer | |
| smtp_user | string | Relay platforms only (SES/SendGrid/Mailgun) |
| smtp_password | string |
Connect a Zoho Mail mailbox through the Zoho API (works on Zoho's free plan). Needs a Self Client id, secret and a generated code from api-console.zoho.com.
| Parameter | Type | Description |
|---|---|---|
| dc | string | Zoho data centre: com, eu, in, com.au, jp, ca |
| code * | string | Self Client code (valid 10 minutes) |
| name | string | |
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
| client_id * | string | |
| client_secret * | string |
{
"name": "connect_zoho_mailbox",
"description": "Connect a Zoho Mail mailbox through the Zoho API (works on Zoho's free plan). Needs a Self Client id, secret and a generated code from api-console.zoho.com.",
"inputSchema": {
"type": "object",
"required": [
"email",
"client_id",
"client_secret",
"code"
],
"properties": {
"dc": {
"type": "string",
"default": "com",
"description": "Zoho data centre: com, eu, in, com.au, jp, ca"
},
"code": {
"type": "string",
"description": "Self Client code (valid 10 minutes)"
},
"name": {
"type": "string"
},
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
},
"client_id": {
"type": "string"
},
"client_secret": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Get a link the user opens to connect Gmail / Google Workspace with Google sign-in (one click, any device). The mailbox appears in list_mailboxes a few minutes after they allow it.
| Parameter | Type | Description |
|---|---|---|
| renew | boolean | Make a fresh link |
{
"name": "google_connect_link",
"description": "Get a link the user opens to connect Gmail / Google Workspace with Google sign-in (one click, any device). The mailbox appears in list_mailboxes a few minutes after they allow it.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"renew": {
"type": "boolean",
"description": "Make a fresh link"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Change a mailbox's display name, daily warm-up cap (1-100, null = default), time zone (IANA, e.g. Europe/London) or the signature added to its warm-up mail (empty = default: full name and company).
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
| timezone | string | |
| daily_cap | ["integer","null"] | |
| signature | string | Up to 500 characters; empty resets to the default |
{
"name": "update_mailbox",
"description": "Change a mailbox's display name, daily warm-up cap (1-100, null = default), time zone (IANA, e.g. Europe/London) or the signature added to its warm-up mail (empty = default: full name and company).",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
},
"timezone": {
"type": "string"
},
"daily_cap": {
"type": [
"integer",
"null"
]
},
"signature": {
"type": "string",
"description": "Up to 500 characters; empty resets to the default"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Pause warm-up for a mailbox.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "pause_mailbox",
"description": "Pause warm-up for a mailbox.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Resume warm-up for a mailbox.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "resume_mailbox",
"description": "Resume warm-up for a mailbox.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Sign in to the mailbox now and report whether the stored login still works.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "test_mailbox",
"description": "Sign in to the mailbox now and report whether the stored login still works.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Remove a mailbox and delete its stored login. Irreversible: ask the user first, then pass confirm=true.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
| confirm * | boolean |
{
"name": "remove_mailbox",
"description": "Remove a mailbox and delete its stored login. Irreversible: ask the user first, then pass confirm=true.",
"inputSchema": {
"type": "object",
"required": [
"email",
"confirm"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
},
"confirm": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Shared network (default: warm with every mailbox on the service) or private pool (only your own mailboxes write to each other; needs 2+).
| Parameter | Type | Description |
|---|---|---|
| private_pool * | boolean |
{
"name": "set_pool_mode",
"description": "Shared network (default: warm with every mailbox on the service) or private pool (only your own mailboxes write to each other; needs 2+).",
"inputSchema": {
"type": "object",
"required": [
"private_pool"
],
"properties": {
"private_pool": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Teach warm-up mail how you write: paste up to 4,000 characters of your own sent emails (tone, length, sign-offs). Empty clears it. Used when the AI writes your warm-up conversations.
| Parameter | Type | Description |
|---|---|---|
| warm_style * | string | Writing samples, max 4,000 characters; empty clears |
{
"name": "set_warm_style",
"description": "Teach warm-up mail how you write: paste up to 4,000 characters of your own sent emails (tone, length, sign-offs). Empty clears it. Used when the AI writes your warm-up conversations.",
"inputSchema": {
"type": "object",
"required": [
"warm_style"
],
"properties": {
"warm_style": {
"type": "string",
"description": "Writing samples, max 4,000 characters; empty clears"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Client workspaces (agencies): each client's mailboxes are kept separate under one login and one bill. Returns id, name and mailbox count. Each mailbox in list_mailboxes has a workspace id (null = My mailboxes).
No parameters.
{
"name": "list_workspaces",
"description": "Client workspaces (agencies): each client's mailboxes are kept separate under one login and one bill. Returns id, name and mailbox count. Each mailbox in list_mailboxes has a workspace id (null = My mailboxes).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a client workspace, e.g. the client's company name (max 100 per account).
| Parameter | Type | Description |
|---|---|---|
| name * | string | Client name, up to 60 characters |
{
"name": "create_workspace",
"description": "Create a client workspace, e.g. the client's company name (max 100 per account).",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Client name, up to 60 characters"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Rename a client workspace.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| workspace_id * | string | Workspace id (ws_…) from list_workspaces |
{
"name": "rename_workspace",
"description": "Rename a client workspace.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"name"
],
"properties": {
"name": {
"type": "string"
},
"workspace_id": {
"type": "string",
"description": "Workspace id (ws_…) from list_workspaces"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a client workspace. Its mailboxes are NOT deleted: they move back to My mailboxes and keep warming. The client's report link stops working.
| Parameter | Type | Description |
|---|---|---|
| workspace_id * | string | Workspace id (ws_…) from list_workspaces |
{
"name": "delete_workspace",
"description": "Delete a client workspace. Its mailboxes are NOT deleted: they move back to My mailboxes and keep warming. The client's report link stops working.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"description": "Workspace id (ws_…) from list_workspaces"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Put a mailbox in a client workspace. Leave workspace_id out (or empty) to move it back to My mailboxes.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
| workspace_id | string | Workspace id (ws_…) from list_workspaces |
{
"name": "move_mailbox_to_workspace",
"description": "Put a mailbox in a client workspace. Leave workspace_id out (or empty) to move it back to My mailboxes.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
},
"workspace_id": {
"type": "string",
"description": "Workspace id (ws_…) from list_workspaces"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}The public read-only report link for one client workspace (mailbox health, spam rate, SPF/DKIM/DMARC). The client opens it without a login; it shows no prices and nothing about other clients.
| Parameter | Type | Description |
|---|---|---|
| workspace_id * | string | Workspace id (ws_…) from list_workspaces |
{
"name": "get_workspace_report",
"description": "The public read-only report link for one client workspace (mailbox health, spam rate, SPF/DKIM/DMARC). The client opens it without a login; it shows no prices and nothing about other clients.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"description": "Workspace id (ws_…) from list_workspaces"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SPF, DKIM selector, DMARC policy and MX for every domain you have connected.
No parameters.
{
"name": "domain_health",
"description": "SPF, DKIM selector, DMARC policy and MX for every domain you have connected.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up a domain's SPF record.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
{
"name": "check_spf",
"description": "Look up a domain's SPF record.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find a domain's DKIM key: tries the selector you give, selectors seen in real mail, then 45 common ones.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
| selector | string |
{
"name": "check_dkim",
"description": "Find a domain's DKIM key: tries the selector you give, selectors seen in real mail, then 45 common ones.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
},
"selector": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up a domain's DMARC record and policy.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
{
"name": "check_dmarc",
"description": "Look up a domain's DMARC record and policy.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Prepaid credit balance, prices and recent charges (Outbound emails, AI drafts).
No parameters.
{
"name": "get_credits",
"description": "Prepaid credit balance, prices and recent charges (Outbound emails, AI drafts).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your Outbound campaigns with status and stats.
No parameters.
{
"name": "list_campaigns",
"description": "Your Outbound campaigns with status and stats.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One campaign: its emails, mailboxes, stats and time left.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign id from list_campaigns |
{
"name": "get_campaign",
"description": "One campaign: its emails, mailboxes, stats and time left.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a draft Outbound campaign (nothing is sent). Emails can use {first_name}, {company} and any contact field. Any connected mailbox can send; one that is still warming shows a warning first.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| emails * | array | 1-4 emails in order |
| mailboxes | array | |
| daily_limit | integer | Per mailbox per day |
{
"name": "create_campaign",
"description": "Create a draft Outbound campaign (nothing is sent). Emails can use {first_name}, {company} and any contact field. Any connected mailbox can send; one that is still warming shows a warning first.",
"inputSchema": {
"type": "object",
"required": [
"name",
"emails"
],
"properties": {
"name": {
"type": "string"
},
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "string"
},
"subject": {
"type": "string"
},
"wait_days": {
"type": "integer",
"description": "Days after the previous email (ignored for the first)"
}
}
},
"description": "1-4 emails in order"
},
"mailboxes": {
"type": "array",
"items": {
"type": "string"
}
},
"daily_limit": {
"type": "integer",
"description": "Per mailbox per day"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Edit a paused or draft campaign. Fields you leave out keep their value.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| emails | array | |
| mailboxes | array | |
| campaign_id * | string | Campaign id from list_campaigns |
| daily_limit | integer |
{
"name": "update_campaign",
"description": "Edit a paused or draft campaign. Fields you leave out keep their value.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"name": {
"type": "string"
},
"emails": {
"type": "array",
"items": {
"type": "object"
}
},
"mailboxes": {
"type": "array",
"items": {
"type": "string"
}
},
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
},
"daily_limit": {
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Add up to 1,000 contacts to a campaign. Each needs email; other fields (first_name, company…) fill the placeholders. Duplicates and unsubscribed addresses are skipped.
| Parameter | Type | Description |
|---|---|---|
| contacts * | array | |
| campaign_id * | string | Campaign id from list_campaigns |
{
"name": "add_contacts",
"description": "Add up to 1,000 contacts to a campaign. Each needs email; other fields (first_name, company…) fill the placeholders. Duplicates and unsubscribed addresses are skipped.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string"
}
}
}
},
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Contacts in a campaign and where each is in the sequence (first 200).
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign id from list_campaigns |
{
"name": "list_campaign_contacts",
"description": "Contacts in a campaign and where each is in the sequence (first 200).",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Start or resume a campaign. This SENDS real email and uses credits. Confirm with the user first. accept_sending_rules=true means the user agrees to https://emailwarmup.bobwork.ai/terms#outbound-beta (only people who may receive it, honest sender, unsubscribe honoured). If a chosen mailbox is still warming the call fails with warming:true; show the user the message and set accept_warming_risk=true only after they explicitly agree. Without credits it fails with credits_required:true: use create_credits_checkout.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign id from list_campaigns |
| accept_warming_risk | boolean | The user agreed to send from mailboxes that have not finished warm-up |
| accept_sending_rules | boolean |
{
"name": "start_campaign",
"description": "Start or resume a campaign. This SENDS real email and uses credits. Confirm with the user first. accept_sending_rules=true means the user agrees to https://emailwarmup.bobwork.ai/terms#outbound-beta (only people who may receive it, honest sender, unsubscribe honoured). If a chosen mailbox is still warming the call fails with warming:true; show the user the message and set accept_warming_risk=true only after they explicitly agree. Without credits it fails with credits_required:true: use create_credits_checkout.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
},
"accept_warming_risk": {
"type": "boolean",
"description": "The user agreed to send from mailboxes that have not finished warm-up"
},
"accept_sending_rules": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Pause a running campaign.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign id from list_campaigns |
{
"name": "pause_campaign",
"description": "Pause a running campaign.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id from list_campaigns"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Payment status after you gave the user a checkout link: credit balance, whether the extra-mailbox subscription is active, mailboxes vs the free limit, and checkouts still waiting for payment. Confirms a paid checkout straight away.
No parameters.
{
"name": "get_billing_status",
"description": "Payment status after you gave the user a checkout link: credit balance, whether the extra-mailbox subscription is active, mailboxes vs the free limit, and checkouts still waiting for payment. Confirms a paid checkout straight away.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get a Stripe Checkout url for extra mailboxes beyond the free limit (monthly, or yearly = 10 months' price for 12). The USER opens it and pays; you cannot. Then poll get_billing_status. Returns already:true when the account is subscribed. Prices come back in the result (prices).
| Parameter | Type | Description |
|---|---|---|
| yearly | boolean | Bill yearly instead of monthly |
{
"name": "create_billing_checkout",
"description": "Get a Stripe Checkout url for extra mailboxes beyond the free limit (monthly, or yearly = 10 months' price for 12). The USER opens it and pays; you cannot. Then poll get_billing_status. Returns already:true when the account is subscribed. Prices come back in the result (prices).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"yearly": {
"type": "boolean",
"description": "Bill yearly instead of monthly"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get a Stripe Checkout url to top up prepaid credits for Outbound sending and AI drafts (one-off $5, $10, $25 or $100; credits never expire). The USER opens it and pays; you cannot. Then poll get_billing_status.
| Parameter | Type | Description |
|---|---|---|
| usd * | integer | one of [5,10,25,100] |
{
"name": "create_credits_checkout",
"description": "Get a Stripe Checkout url to top up prepaid credits for Outbound sending and AI drafts (one-off $5, $10, $25 or $100; credits never expire). The USER opens it and pays; you cannot. Then poll get_billing_status.",
"inputSchema": {
"type": "object",
"required": [
"usd"
],
"properties": {
"usd": {
"enum": [
5,
10,
25,
100
],
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Domains bought in the domain shop, their hosted mailboxes, renewal date and price, plus IMAP/SMTP settings.
No parameters.
{
"name": "list_bought_domains",
"description": "Domains bought in the domain shop, their hosted mailboxes, renewal date and price, plus IMAP/SMTP settings.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find available lookalike domains for cold email, with first-term and renewal prices.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Brand or domain, e.g. acme |
{
"name": "search_domains",
"description": "Find available lookalike domains for cold email, with first-term and renewal prices.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Brand or domain, e.g. acme"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Buy domains with up to 3 mailboxes each. Returns a Stripe checkout link for the person to pay; setup starts once paid. Needs accept_sending_rules true.
| Parameter | Type | Description |
|---|---|---|
| domains * | array | |
| accept_sending_rules * | boolean |
{
"name": "buy_domains",
"description": "Buy domains with up to 3 mailboxes each. Returns a Stripe checkout link for the person to pay; setup starts once paid. Needs accept_sending_rules true.",
"inputSchema": {
"type": "object",
"required": [
"domains",
"accept_sending_rules"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
},
"mailboxes": {
"type": "array",
"items": {
"type": "object",
"required": [
"local"
],
"properties": {
"name": {
"type": "string",
"description": "Display name"
},
"local": {
"type": "string",
"description": "Part before @, e.g. john"
}
}
}
}
}
}
},
"accept_sending_rules": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Add mailboxes to a domain you bought here ($3 per mailbox per month). Returns a Stripe checkout link.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
| mailboxes * | array |
{
"name": "add_hosted_mailboxes",
"description": "Add mailboxes to a domain you bought here ($3 per mailbox per month). Returns a Stripe checkout link.",
"inputSchema": {
"type": "object",
"required": [
"domain",
"mailboxes"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
},
"mailboxes": {
"type": "array",
"items": {
"type": "object",
"required": [
"local"
],
"properties": {
"name": {
"type": "string",
"description": "Display name"
},
"local": {
"type": "string",
"description": "Part before @, e.g. john"
}
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Password, IMAP and SMTP settings for one of your hosted mailboxes.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Mailbox address, e.g. sales@yourdomain.com |
{
"name": "hosted_mailbox_login",
"description": "Password, IMAP and SMTP settings for one of your hosted mailboxes.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}DNS records on a domain you bought here.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
{
"name": "list_dns_records",
"description": "DNS records on a domain you bought here.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add a DNS record to a domain you bought here. name = subdomain ('' for the domain itself). Types A, AAAA, CNAME, ALIAS, MX, TXT, CAA, SRV.
| Parameter | Type | Description |
|---|---|---|
| ttl | integer | |
| name | string | |
| prio | integer | |
| type * | string | |
| domain * | string | Domain, e.g. yourdomain.com |
| content * | string |
{
"name": "add_dns_record",
"description": "Add a DNS record to a domain you bought here. name = subdomain ('' for the domain itself). Types A, AAAA, CNAME, ALIAS, MX, TXT, CAA, SRV.",
"inputSchema": {
"type": "object",
"required": [
"domain",
"type",
"content"
],
"properties": {
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"prio": {
"type": "integer"
},
"type": {
"type": "string"
},
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
},
"content": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a DNS record by id (from list_dns_records). Deleting MX, SPF, DKIM or DMARC stops the mailboxes working.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain, e.g. yourdomain.com |
| record_id * | string |
{
"name": "delete_dns_record",
"description": "Delete a DNS record by id (from list_dns_records). Deleting MX, SPF, DKIM or DMARC stops the mailboxes working.",
"inputSchema": {
"type": "object",
"required": [
"domain",
"record_id"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain, e.g. yourdomain.com"
},
"record_id": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Manage the user's BobWork Email Warm-up account: connect mailboxes (IMAP/SMTP, Zoho, or a Google sign-in link), watch warm-up health and spam rate, check SPF/DKIM/DMARC, and run Outbound campaigns from any connected mailbox. Mailboxes are ready for outbound after 7 days under 10% spam. Removing a mailbox deletes its stored login, so confirm with the user first. Starting a campaign sends real email and uses credits ($2 per 1,000): show the user the campaign and get a clear yes before calling start_campaign. If start_campaign answers warming:true, show the user the warning and pass accept_warming_risk=true only after they agree. Money: the user pays, you never do. Over the free mailbox limit or out of credits, call create_billing_checkout or create_credits_checkout, give the returned url to the user, then poll get_billing_status until it shows the payment. No key yet: sign up without a browser with POST https://app-emailwarmup.bobwork.ai/api/v1/signup/code then /signup/verify (a code is emailed to the user).
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "connect_imap_mailbox",
"description": "Connect any mailbox with IMAP + SMTP. The login is tested before it is saved. Use an app password when two-factor sign-in is on. Give a preset (see list_providers) or the hosts. Warm-up starts the same day.",
"inputSchema": {
"type": "object",
"required": [
"email",
"password"
],
"properties": {
"host": {
"type": "string",
"description": "IMAP host (if no preset)"
},
"name": {
"type": "string",
"description": "Display name on sent mail"
},
"port": {
"type": "integer"
},
"user": {
"type": "string",
"description": "Login if not the email"
},
"email": {
"type": "string",
"description": "Mailbox address, e.g. sales@yourdomain.com"
},
"preset": {
"type": "string",
"description": "e.g. gmail-imap, yahoo, icloud, zoho, lark, aws-ses, sendgrid, mailgun, other"
},
"password": {
"type": "string",
"description": "Mailbox password or app password"
},
"smtp_host": {
"type": "string"
},
"smtp_port": {
"type": "integer"
},
"smtp_user": {
"type": "string",
"description": "Relay platforms only (SES/SendGrid/Mailgun)"
},
"smtp_password": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}