Serveur MCP
agent-cold-email
io.github.YS-projectcalc/agent-cold-email
Ce que fait ce MCP
Manages cold-email infrastructure, lead lists, campaigns, mailbox provisioning, sending, replies, suppression, and deliverability monitoring.
Capacités
Outils
28
outils
account
Account overview: brand, plan, status, billingState, activationState, resource counts, usageCents, quota, deliverability (loop state: paused/throttled mailboxes, burning domains, auto-replacements, recentActions[]), and teardown (reclaim summary once canceled, else null). Billing is per-provisioned-mailbox on the live provisioned count: $49 platform + per mailbox, graduated: 1-5 at $10, 6-20 at $8, 21+ at $7; 5-mailbox minimum ($99 at 5); the billed quantity tracks the real provisioned count (deprovision lowers it). activationState is the HONEST send state — trust it over 'sent' counts: 'active' = real sending live; 'pending_provisioning' = paid but infrastructure still being armed, sends shown are sandbox previews that DON'T leave; 'capacity_pending' = provisioning held at a spend limit; 'screening_hold' = account under review; 'sandbox' = demo/free. Use metrics for counts, infrastructure_status for per-mailbox health.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
ack_message
Acknowledge a message by id (from list_messages or infrastructure_status's messages[]) — sets it read so it stops surfacing as unacked. THIS IS THE ONLY THING THAT SETS readAt: reading or listing messages never marks them, so a message stays unacked until you call this explicitly. Idempotent: acking an already-acked id returns success with no second effect, never an error. 404 if the id doesn't exist for this tenant.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['messageId'], 'properties': {'messageId': {'type': 'string', 'minLength': 1, 'description': "The message id, from list_messages or infrastructure_status's messages[]."}}}
activity
Unified activity feed: campaign events (sent/reply/bounce/...) merged with deliverability loop actions (pause/throttle/replace-domain). Cursor-paginated → { items[], nextCursor }; each item { id, kind:'event'|'deliverability', label, ts, target, detail }. Filters: kind, limit (default 50, max 200). Use inbox for replies only.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'enum': ['event', 'deliverability'], 'type': 'string'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 500, 'minLength': 1}}}
campaign_results
Outcome counts for ONE campaign. Input: campaignId (from launch_campaign). Returns { campaignId, sent, reply, bounce, complaint, unsubscribe, failed, soft_bounce } — bounce = HARD only, soft_bounce separate, opens not tracked. 404 if unknown. Use metrics for account-wide totals, list_campaigns for every campaign at once.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId'], 'properties': {'campaignId': {'type': 'string', 'minLength': 1, 'description': 'The campaign id returned by launch_campaign.'}}}
configure_byo_domain
Register or advance a BYO domain/mailbox intake (SPEC.md §20). action = register (needs domain + domainRelationship: fresh_standalone|subdomain_of_primary|is_primary — runs the pre-flight live-infra scan + abuse gate + reputation ladder, returns the starting byoStatus) | poll_dns (needs id — re-checks DNS delegation/records, advances pending_dns → active, or → abandoned after 7 idle days) | acknowledge_consent (needs id + acknowledged:true — REQUIRED before a primary domain can proceed past pending_consent; this does not remove your business's exposure, it documents informed consent) | request_managed_mailboxes (needs id + count — platform-provisioned mailboxes on an ALREADY-ACTIVE domain, the primary shape; every response carries a `billing` projection { provisionedAfter, projectedMonthlyCents, formula } — quoteOnly:true previews it without provisioning) | connect_mailbox (needs id + email + transport — declares an EXISTING OAuth/SMTP+IMAP connection you already have, bypassing provisioning; transport is { kind:'smtp', host, port, secure, user, pass } | { kind:'gmail_api', clientId, clientSecret, refreshToken } | { kind:'ms_graph', mode, tenantId, clientId, clientSecret, refreshToken? }).
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Required for poll_dns/acknowledge_consent/request_managed_mailboxes/connect_mailbox — the domainId from register.'}, 'count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Required for request_managed_mailboxes — how many platform-provisioned mailboxes to attach.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'description': 'Required for connect_mailbox — the existing mailbox address.'}, 'action': {'enum': ['register', 'poll_dns', 'acknowledge_consent', 'request_managed_mailboxes', 'connect_mailbox'], 'type': 'string'}, 'domain': {'type': 'string', 'maxLength': 253, 'minLength': 3, 'description': 'Required for register.'}, 'quoteOnly': {'type': 'boolean', 'description': 'Optional for request_managed_mailboxes — true previews the new mailbox count + projected monthly price WITHOUT provisioning (SPEC §18 quote-before-add).'}, 'transport': {'oneOf': [{'type': 'object', 'required': ['kind', 'host', 'port', 'secure', 'user', 'pass'], 'properties': {'host': {'type': 'string', 'minLength': 1}, 'kind': {'type': 'string', 'const': 'smtp'}, 'pass': {'type': 'string', 'minLength': 1}, 'port': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'user': {'type': 'string', 'minLength': 1}, 'secure': {'type': 'boolean'}}}, {'type': 'object', 'required': ['kind', 'clientId', 'clientSecret', 'refreshToken'], 'properties': {'kind': {'type': 'string', 'const': 'gmail_api'}, 'clientId': {'type': 'string', 'minLength': 1}, 'clientSecret': {'type': 'string', 'minLength': 1}, 'refreshToken': {'type': 'string', 'minLength': 1}}}, {'type': 'object', 'required': ['kind', 'mode', 'tenantId', 'clientId', 'clientSecret'], 'properties': {'kind': {'type': 'string', 'const': 'ms_graph'}, 'mode': {'enum': ['delegated', 'app_only'], 'type': 'string'}, 'clientId': {'type': 'string', 'minLength': 1}, 'tenantId': {'type': 'string', 'minLength': 1}, 'clientSecret': {'type': 'string', 'minLength': 1}, 'refreshToken': {'type': 'string', 'minLength': 1}}}], 'description': "Required for connect_mailbox — { kind: 'smtp', host, port, secure, user, pass } | { kind: 'gmail_api', clientId, clientSecret, refreshToken } | { kind: 'ms_graph', mode: 'delegated'|'app_only', tenantId, clientId, clientSecret, refreshToken? }."}, 'personaSlug': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'Optional for request_managed_mailboxes — defaults to a slug of the domain.'}, 'acknowledged': {'type': 'boolean', 'const': True, 'description': "Required (must be true) for acknowledge_consent — SPEC.md §20.4's separate, unbundled risk acknowledgment."}, 'domainRelationship': {'enum': ['fresh_standalone', 'subdomain_of_primary', 'is_primary'], 'type': 'string', 'description': 'Required for register: fresh_standalone | subdomain_of_primary | is_primary.'}}}
configure_dashboard
Write a saved dashboard view. action = create (needs name+layout) | update (needs id+rev+layout; optional name renames) | promote (id → default) | delete (id). update is rev-CAS: a stale rev returns { currentRev, currentLayout } to rebase and retry. Optional note. Read the current rev+layout via get_dashboard first.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Required for update/promote/delete.'}, 'rev': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': "Required for update — the rev this edit is based on; stale vs. the view's CURRENT rev returns a structured conflict with currentRev/currentLayout to rebase onto."}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Required for create. Optional for update — pass it to rename the view; omit to leave the name unchanged.'}, 'note': {'type': 'string', 'maxLength': 2000, 'description': 'Optional human-readable note recorded alongside this edit (edited_by_note).'}, 'action': {'enum': ['create', 'update', 'promote', 'delete'], 'type': 'string'}, 'layout': {'type': 'object', 'required': ['schemaVersion', 'widgets'], 'properties': {'widgets': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'kpi_row'}, 'props': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 200}, 'metrics': {'type': 'array', 'items': {'enum': ['sent', 'reply', 'bounce', 'soft_bounce', 'complaint', 'unsubscribe', 'failed'], 'type': 'string'}, 'default': ['sent', 'reply', 'bounce'], 'maxItems': 7, 'minItems': 1}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'mailbox_health'}, 'props': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 200}, 'showWarmup': {'type': 'boolean', 'default': True}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'campaign_performance'}, 'props': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 200}, 'campaignId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'activity_feed'}, 'props': {'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'title': {'type': 'string', 'maxLength': 200}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'inbox_preview'}, 'props': {'type': 'object', 'properties': {'label': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 50, 'minimum': 1}, 'title': {'type': 'string', 'maxLength': 200}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'agent_log'}, 'props': {'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'title': {'type': 'string', 'maxLength': 200}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'agent_note'}, 'props': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 200}, 'markdown': {'type': 'string', 'default': '', 'maxLength': 10000}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}, {'type': 'object', 'required': ['id', 'type', 'gridPos', 'props'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'type': 'string', 'const': 'quota_usage'}, 'props': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 200}, 'refreshSeconds': {'type': 'integer', 'default': 30, 'maximum': 3600, 'minimum': 5}}}, 'gridPos': {'type': 'object', 'required': ['x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'w': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'x': {'type': 'integer', 'maximum': 11, 'minimum': 0}, 'y': {'type': 'integer', 'maximum': 1000, 'minimum': 0}}}, 'visible': {'type': 'boolean', 'default': True}}}]}, 'maxItems': 50}, 'schemaVersion': {'type': 'number', 'const': 1}}, 'description': 'Required for create/update.'}}}
configure_webhook
Manage an outbound webhook subscription. action = create (needs url + eventTypes: reply|bounce|soft_bounce|complaint|unsubscribe; optional secret/active) | update (needs id + one changed field; active:true re-enables an auto-disabled one, active:false pauses; secret rotates) | delete (needs id). create/rotate return the HMAC signing secret ONCE. URLs must be https to a public host (private/metadata IPs rejected). Deliveries are signed X-Coldrig-Signature: sha256=HMAC-SHA256(secret, raw body).
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Required for update/delete.'}, 'url': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'Required for create. HTTPS endpoint; private/link-local/metadata IPs are rejected.'}, 'note': {'type': 'string', 'maxLength': 2000, 'description': 'Ignored placeholder for symmetry; webhooks record no provenance note.'}, 'action': {'enum': ['create', 'update', 'delete'], 'type': 'string'}, 'active': {'type': 'boolean', 'description': 'Optional. On update, active:true re-enables an auto-disabled subscription; active:false pauses delivery.'}, 'secret': {'type': 'string', 'maxLength': 200, 'minLength': 16, 'description': 'Optional signing secret (>=16 chars). Omit on create to have one generated; pass on update to rotate.'}, 'eventTypes': {'type': 'array', 'items': {'enum': ['reply', 'bounce', 'soft_bounce', 'complaint', 'unsubscribe'], 'type': 'string'}, 'maxItems': 5, 'minItems': 1, 'description': 'Required for create: which events to push (reply | bounce | soft_bounce | complaint | unsubscribe).'}}}
contact_operator
Reach a human operator — for anything list_messages/infrastructure_status can't answer (a stuck vendor issue, a billing question, an account-level ask). Inputs: body (1-2000 chars), urgency ('normal' | 'needs_human', default 'normal'). Files a support ticket and notifies the operator; returns { ticketId, note, deduplicated }. Works in every account state a tenant token still authenticates in, including dunning-suspended, canceling and canceled — this is exactly the channel for 'why is my account suspended?'. The ONE exception is an admin-TERMINATED (abuse) account, whose token is rejected at auth with 401 before this tool runs. The operator's reply arrives as a message on THIS account (poll list_messages / infrastructure_status.messages[] — there is no separate reply-fetch call). Sending the IDENTICAL body AND urgency again within an hour returns the SAME ticketId and does not file a second ticket or send a second alert (`deduplicated: true` on that response; `false` when a new ticket was actually filed) — no separate idempotency key is needed to retry a dropped response. This is a TEXT match, not an intent match: the platform cannot tell a deliberate retry from a coincidentally-identical NEW message, so a genuinely new ask with the same wording collapses into the earlier ticket just as silently — vary the wording (or raise urgency, which is always treated as an escalation and files a new ticket) if you have something new to say. 'needs_human' also bypasses the ~10-minute ops-email throttle so an urgent message is pushed immediately. Rate-limited to 5 calls/hour per tenant — a 429 names retryAfter (seconds) when hit.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'urgency': {'enum': ['normal', 'needs_human'], 'type': 'string', 'default': 'normal'}}}
get_byo_domains
List your BYO (bring-your-own) domains, or (with id) one domain's full intake detail. No id → [{ domainId, domain, isPrimary, dnsMode, byoStatus, breakerTier, reputationBranch, mailboxCount }]. With id → adds the pre-flight scan result, abuse-gate verdict, and consent-acknowledgment status. byoStatus progresses pending_kyc|pending_consent|pending_dns → active (or rejected/abandoned). Use configure_byo_domain to register a new one or advance it.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Omit to list every BYO domain; pass an id for that domain's full intake detail (scan result, abuse verdict, consent status)."}}}
get_dashboard
Read saved dashboard views. No id → list all: [{ id, name, isDefault, rev, editedBy }]. With id → that view's full layout + rev (pass this rev as the CAS base to configure_dashboard update). Views are both agent- and human-editable; write them with configure_dashboard.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Omit to list every saved view (summary); pass a view id for its full layout + rev.'}}}
get_webhooks
List your outbound webhook subscriptions, or (with id) one subscription plus its recent delivery + attempt log. No id → [{ id, url, eventTypes, active, status, disabledReason, consecutiveFailures }]. With id → { subscription, recentDeliveries[], recentAttempts[] }. Secrets are never returned on reads — they are shown once at create/rotate.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Omit to list every subscription; pass an id for that subscription plus its recent delivery + attempt log.'}}}
inbox
Unified reply inbox across mailboxes. Cursor-paginated → { threads[], nextCursor }; each row: threadId, campaignName, leadEmail, subject, mailboxEmail, label, lastEventType, markStatus. Filters: mailbox, campaign, label, read, includeNonreply (bounces/OOO, default true), archived (exclude|include|only). Use thread for one thread's history.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'read': {'type': 'boolean'}, 'label': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'mailbox': {'type': 'string', 'maxLength': 320, 'minLength': 1}, 'archived': {'enum': ['exclude', 'include', 'only'], 'type': 'string', 'default': 'exclude'}, 'campaign': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'includeNonreply': {'type': 'boolean', 'default': True}}}
infrastructure_status
Warmup + provisioning progress per mailbox. New mailboxes are ramp-limited server-side: 5 sends/day week 1 rising to 40/day after 4 weeks; current dailyCap for each mailbox is in the response below — ramp caps permit CAPPED sending from day 1, never zero until fully warmed. Returns { domains, mailboxes, sendReady, mailboxHealth[], messages[], nextSteps }; each mailbox: warmupDay, dailyCap, sentToday, sendReady, delivStatus (healthy/throttled/paused), complaint/bounce/softBounce rates (first-party measured), vendorReputationScore + vendorPlacementRate (VENDOR-REPORTED, not first-party measurements — the control loop uses local signals only; BOTH ARE null whenever the provider does not report them, which is the normal case today, so treat null as 'not measured' and never as zero), lastPolledAt. Per-mailbox `sendReady` is a FULLY-RAMPED flag, NOT a send gate — a mailbox below full ramp still sends, capped at its own `dailyCap`; `sendReady` only says warmup has finished, so read `dailyCap`/`sentToday` for actual send capacity, never `sendReady` alone. The top-level `sendReady` is the AND across ALL mailboxes (true only once every one has finished ramping) — for whether THIS mailbox can send right now, the per-mailbox flag next to it is the one that matters, not the top-level one. Vendor-pool warmup (the underlying reputation-building the provider runs) is FEED-INVISIBLE by design: nothing in this response surfaces the vendor's own warmup internals — dailyCap/warmupDay/sendReady here are this platform's own ramp schedule, computed independently of whatever the vendor is doing in its pool, so do not expect a vendor-side warmup event to show up here. `messages[]` surfaces system notices this account should act on (e.g. a setup step that needs a retry, a mailbox credential that just went live) — each has kind, severity ('info' = resolves on its own | 'action_required' = nothing progresses until you act, and acting works | 'operator_pending' = the platform has stopped and nothing you change will restart it, but an operator can clear the blocker and then retrying the SAME call with the SAME idempotency key completes it — keep your inputs as they are and do not give up | 'terminal' = the platform has STOPPED, retrying will never help and only a human can move it — the actionHint names contact_operator), body, actionHint (structured — e.g. which tool + idempotencyKey to retry with), createdAt; poll this alongside the mailbox fields — capped at the newest 5 (operator replies sort first, so system churn cannot evict one, but a 6th DISTINCT unacked message of either kind can still fall off this preview; use list_messages for the complete, paginated history). Reading them here does NOT mark them read — only an explicit ack_message call sets readAt. Unacked operator messages sort first here, then system notices newest-first, so a human reply is never pushed out of the 5 by system churn; list_messages is the full paginated surface. `nextSteps` names what this account should do next — see setup_infrastructure's description for the discriminated shape. Use account/metrics for account-wide rollups.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
label_thread
Set or clear a triage LABEL on an inbox thread — the same chip the dashboard shows. Inputs: threadId, label (string; pass label:null to clear). Distinct from mark (read/unread/archived state): a label is a free-form category, not a read flag. Filterable via inbox's label param.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId'], 'properties': {'label': {'anyOf': [{'type': 'string', 'maxLength': 100, 'minLength': 1}, {'type': 'null'}], 'default': None}, 'threadId': {'type': 'string', 'minLength': 1, 'description': 'The thread id, e.g. from inbox() or campaign events.'}}}
launch_campaign
Create and activate a campaign on a lead list. You supply name, offer, leads[], sequence[] (per step: subject, body, delayDays — subject is REQUIRED on step 1; a LATER step may omit it to keep step 1's subject line [recommended], which resolves at launch to "Re: " + step 1's subject (unchanged if that already starts with "Re: "), or set one explicitly to change only that step's subject line — every later step is still sent In-Reply-To step 1, though some mail clients display a changed subject as a separate conversation), and optionally timezone, sendWindow, stopOnReply — the platform does not write copy. Each step's `step` number must be unique within the sequence; a duplicate step number is refused (400) naming it. Subjects and bodies may use {{firstName}} and {{company}} (filled from each lead); a launch is refused (400) if any subject or body uses any other {{token}}, a single-brace form of a known token such as {firstName} or {company} (a typo for the double-brace form — it would otherwise reach the recipient unsubstituted), or a run of 3 or more consecutive `{` or `}` anywhere (e.g. {{{firstName}}} or a lopsided run like {{{firstName}} — it would otherwise reach the recipient with stray braces attached). The send window is evaluated in `timezone` (IANA, e.g. America/New_York; default UTC) — set it to your recipients' zone. sendWindow is { startHour, endHour, days? }: integer hours 0-23, endHour INCLUSIVE (the last hour a send may start in), days 0=Sunday … 6=Saturday. Each omitted field (or all of them, by omitting sendWindow) gets the platform's RECOMMENDED default {"startHour":8,"endHour":16,"days":[1,2,3,4,5]} — Monday-Friday business hours — except on a sandbox account, where omitted fields are open every hour of every day until it upgrades and they take that default; the decision is yours, e.g. include 0 and 6 in days to send on weekends. Setting exactly ONE of startHour/endHour combines it with the recommended default for the OTHER (08/16, including on a sandbox account, since that value re-resolves to the same default on upgrade) — if that combination would wrap the window past midnight (start > end), the launch is refused; set both explicitly, including for a deliberate overnight window such as {startHour:22, endHour:6}. Step 1 goes out from the least-loaded mailbox; each later step goes out delayDays after the previous step ACTUALLY sent, from the SAME mailbox, with In-Reply-To/References set to step 1's Message-ID — it waits while that mailbox is at its daily cap, and the lead's remaining steps are cancelled (a 'failed' event says why) once that mailbox is paused or released, since neither ever lifts on its own, or when a paid account's thread went out from a connected BYO mailbox, which this build never sends from; a step whose previous step never went out is skipped. Suppressed leads are skipped. Returns { campaignId, sendWindow, timezone, nextSteps } — sendWindow and timezone are what actually applied. Campaigns send real mail, so a launch identical to one this account made in the last 60 seconds is REFUSED with 409 { code:'duplicate_campaign', existingCampaignId } rather than contacting the same prospects twice — check that campaign instead of relaunching. Resend the same idempotencyKey to retry a call whose response you lost: that replays the original result instead of being refused. Campaigns that differ in any field, and deliberate relaunches after those 60 seconds, are never blocked.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'offer', 'leads', 'sequence'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'leads': {'type': 'array', 'items': {'type': 'object', 'required': ['email', 'firstName'], 'properties': {'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'company': {'type': 'string', 'default': '', 'maxLength': 200, 'minLength': 0}, 'firstName': {'type': 'string', 'maxLength': 200, 'minLength': 1}}}, 'maxItems': 5000, 'minItems': 1}, 'offer': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'sequence': {'type': 'array', 'items': {'type': 'object', 'required': ['step', 'body', 'delayDays'], 'properties': {'body': {'type': 'string', 'maxLength': 20000, 'minLength': 1}, 'step': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'subject': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Required on step 1. A LATER step (step > 1) may omit it to keep step 1\'s subject line (recommended) — it resolves at launch to "Re: " + step 1\'s subject (unchanged if that already starts with "Re: "). Set one explicitly on a later step to change only its subject line: every later step is still sent In-Reply-To step 1, though some mail clients display a changed subject as a separate conversation.'}, 'delayDays': {'type': 'integer', 'maximum': 60, 'minimum': 0}}}, 'maxItems': 10, 'minItems': 1}, 'timezone': {'type': 'string', 'default': 'UTC', 'maxLength': 100, 'minLength': 1, 'description': "IANA time zone the send window is evaluated in — set it to your recipients' zone. Default UTC."}, 'sendWindow': {'type': 'object', 'properties': {'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'minItems': 1, 'description': 'Weekdays sends may go out on, in `timezone`: 0 = Sunday … 6 = Saturday. Omit for [1,2,3,4,5] (every day while the account is a sandbox); include 0 and 6 to send on weekends.'}, 'endHour': {'type': 'integer', 'maximum': 23, 'minimum': 0}, 'startHour': {'type': 'integer', 'maximum': 23, 'minimum': 0}}, 'description': 'Integer hours 0-23 (endHour inclusive: the last hour a send may start in) and weekdays, evaluated in `timezone`. Each field you omit (or all of them, by omitting sendWindow) gets the recommended {"startHour":8,"endHour":16,"days":[1,2,3,4,5]} — except on a sandbox account, where omitted fields are open every hour of every day until it upgrades and they take the recommended default. If you set exactly ONE of startHour/endHour, the other still defaults to the recommended value (08/16) — if that combination would wrap past midnight (start > end), the launch is refused; set both explicitly, including for a deliberate overnight window.'}, 'stopOnReply': {'type': 'boolean', 'default': True}, 'idempotencyKey': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional idempotency key: resend the SAME key when retrying this call so a dropped-response retry is not applied twice (no duplicate campaign/provision/send).'}}}
list_campaigns
List every campaign at once: [{ campaignId, name, status, counts{sent,reply,bounce,complaint,unsubscribe,failed,soft_bounce} }], newest first — no per-campaign lookup needed. Use campaign_results for one campaign's counts, metrics for account-wide totals.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_leads
List/export leads with their contact-level disposition, cursor-paginated. Returns { leads[], nextCursor }; each row: leadId, email, firstName, company, campaignId, campaignName, globalStatus, interestStatus, notes, tags, suppressed, lastEventType, lastEventTs, createdAt. Filters: campaign, interestStatus, suppressed, replied. This IS the export surface — paginate to dump the full book of business as JSON (no separate CSV endpoint). Use update_lead to write disposition, suppress_lead to opt an address out.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'replied': {'type': 'boolean'}, 'campaign': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'suppressed': {'type': 'boolean'}, 'interestStatus': {'enum': ['none', 'interested', 'meeting_booked', 'not_now', 'not_interested', 'bad_fit', 'out_of_office', 'wrong_person'], 'type': 'string'}}}
list_messages
List this tenant's system + operator messages (a retryable setup step, a credential going live, an operator notice), cursor-paginated. Unacked messages sort first (newest first within that group), then acked ones (also newest first). Returns { messages[], nextCursor }; each message: id, kind, severity ('info'|'action_required'|'operator_pending'|'terminal' — 'operator_pending' means the platform has stopped, nothing you change restarts it, and an operator clearing the blocker makes the SAME retry work, so keep the same inputs and idempotency key; 'terminal' means the platform has stopped and only a human can move it, so do NOT retry), body, actionHint (structured — e.g. which tool + idempotencyKey to retry with), source ('system'|'operator'), createdAt, readAt. `readAt` is set ONLY by an explicit ack_message call — LISTING messages never marks them, here or anywhere else, so calling this tool leaves every readAt exactly as it was. A null readAt therefore means 'not acked', which is NOT evidence the message was never seen: it may have been read and simply not acknowledged. Use ack_message to acknowledge one by id so it stops resurfacing. infrastructure_status also inlines the newest 5 unacked messages for a quick glance — this is the full paginated surface.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 500, 'minLength': 1}}}
mark
Set a thread's READ-STATE for inbox triage. Inputs: threadId, status = 'read' | 'unread' | 'archived' (archived hides it from the default inbox; refetch with inbox archived='include'/'only'). Returns { marked: true }. 404 if unknown. This is the read/archive flag ONLY — use label_thread for a triage label chip, reply to respond.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId', 'status'], 'properties': {'status': {'enum': ['read', 'unread', 'archived'], 'type': 'string'}, 'threadId': {'type': 'string', 'minLength': 1, 'description': 'The thread id, e.g. from inbox() or campaign events.'}}}
metrics
Account-wide outcome totals across ALL campaigns: { sent, reply, bounce, complaint, unsubscribe, failed, soft_bounce } — same shape as campaign_results but summed tenant-wide (bounce = hard only, opens not tracked). Use campaign_results for one campaign, list_campaigns per-campaign, or account for billing/quota.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
pause
Pause ONE campaign: its status → 'paused', so the tick schedules no further steps (already-sent mail is unaffected; there is no resume tool). Input: campaignId. Returns { paused: true }. 404 if not found. Use pause_all to pause every active campaign at once.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId'], 'properties': {'campaignId': {'type': 'string', 'minLength': 1, 'description': 'The campaign id returned by launch_campaign.'}}}
pause_all
Pause EVERY active campaign for the tenant at once (each active status → 'paused'; the tick then schedules no further sends). No inputs. Returns { pausedAll: true }. Use pause to pause a single campaign by id.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
remove_mailboxes
Downgrade: release your N NEWEST live mailboxes now and lower the billed quantity. Inputs: count, acknowledged (must be true — this is a quoted, irreversible-this-cycle consent: the release is immediate for provisioning but there is NO mid-cycle credit; the lower price takes effect next renewal, minimum 5 mailboxes / $99). Returns { releasedCount, failedCount, unreleased, billing, deduplicated } where billing is the new projected monthly. `releasedCount` is what COMPLETED and can be less than the `count` you asked for; `failedCount` is how many the provider refused, which are STILL LIVE and still billed, and `unreleased` names those addresses — read them before concluding a downgrade landed. `deduplicated: true` means this call did NOT re-perform the downgrade — every count above describes an EARLIER call's already-recorded outcome under the same idempotencyKey, not new work done just now. This can be true even after the 30-day idempotency window itself has expired: the underlying release record persists independently, so a reused key still reports no re-release rather than silently starting a fresh one. `count` is RELATIVE — it releases that many MORE mailboxes, it does not set your fleet to that size — and release cannot be undone through this API, so ALWAYS pass an idempotencyKey: the FIRST call under a key resolves WHICH mailboxes to release and records that exact set, so every later call carrying the SAME key can only ever finish that same set. A same-key retry re-attempts the stragglers and can never release a mailbox outside them, whatever `count` you send with it (the recorded set wins over a changed count); a retry WITHOUT a key always releases another `count`. A genuine SECOND downgrade is therefore a NEW key — reusing an old one can only ever finish what that key already asked for. A call that came back with failedCount above zero did NOT finish, so its key is not frozen: resend the identical request with the same key until failedCount is 0 — from then on that key replays the finished result and releases nothing further. If a call returns 409 a release is already running for this account: wait, then re-read infrastructure_status before deciding whether to retry. To ADD mailboxes use setup_infrastructure / configure_byo_domain (request_managed_mailboxes).
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['count', 'acknowledged'], 'properties': {'count': {'type': 'integer', 'maximum': 60, 'minimum': 1}, 'acknowledged': {'type': 'boolean', 'const': True}, 'idempotencyKey': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional idempotency key: resend the SAME key when retrying this call so a dropped-response retry is not applied twice (no duplicate campaign/provision/send).'}}}
reply
Send a reply on an existing thread, from the mailbox that sent it. Inputs: threadId, body. Returns { messageId, deduplicated }. A reply is real sending volume and is governed exactly like campaign sends: it counts against that mailbox's daily cap (sentToday +1, visible in infrastructure_status), and it is REFUSED — never silently dropped — when the recipient is suppressed, the mailbox is deliverability-paused, or the cap is used up. A refusal returns { error, code:'send_blocked', reason:'suppressed'|'mailbox_paused'|'daily_cap_reached', retryable }: retryable (cap) clears at the next daily rollover, non-retryable does not, so stop retrying and don't loop replies to manufacture volume. Idempotent: identical retries collapse to one send — pass a stable idempotencyKey (else a body hash is used) so a dropped-response retry can't double-send. `deduplicated: true` means NO new email was sent — `messageId` is from an earlier send this call matched. `deduplicated: false` means this platform sent the call onward as a NEW send, which is normally a new email — but it is not a guarantee one left the building: with NO idempotencyKey the body hash is only matched here for 10 minutes, while the sending provider keeps its own record of an identical body on the same thread for longer, and can collapse a much later repeat into the original send. So on a long-delayed identical repeat you may get `deduplicated: false` with the ORIGINAL send's messageId and no new email. PASS AN IDEMPOTENCYKEY, or vary the body, if you need a repeat to genuinely go out. 404 if no sending mailbox is on record for the thread.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 20000, 'minLength': 1}, 'threadId': {'type': 'string', 'minLength': 1, 'description': 'The thread id, e.g. from inbox() or campaign events.'}, 'idempotencyKey': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional idempotency key: resend the SAME key when retrying this call so a dropped-response retry is not applied twice (no duplicate campaign/provision/send).'}}}
setup_infrastructure
Provision sending infrastructure: buy branded lookalike domains, create mailboxes, start warmup. New mailboxes are ramp-limited server-side — 5 sends/day in week 1, rising to 40/day after 4 weeks — and your own calls cannot exceed that cap; poll infrastructure_status for the current dailyCap. Inputs: brand, primaryDomain, domains + inboxesEach counts, persona, physicalAddress, senderIdentity. Billing is per-provisioned-mailbox ($49 platform + per mailbox, graduated: 1-5 at $10, 6-20 at $8, 21+ at $7; 5-mailbox minimum) and the billed quantity follows what you provision here — pass quoteOnly:true first to preview the new count + projected monthly price before committing (no silent capacity addition). Every response carries a `billing` projection { provisionedAfter (the live count AFTER this call — reality, not the ask), projectedMonthlyCents, formula }: on quoteOnly it's the preview, on an actual provision it's the real post-provision bill (a capacity-limited partial reflects only what landed). Returns { jobId, billing } — `jobId` is a correlation id only, not a trackable job handle: there is no job store and no endpoint that accepts it, so do not poll for it or treat its presence as meaningful; it exists to correlate this response with logs. A `provisioning` field is present ONLY when the call returned still OWING work, and names which state: 'pending' (a domain's DNS registration is still completing — `pendingDomain` names one of them) or 'capacity_pending' (held at a spend limit, so polling will NOT progress until an operator raises it — call contact_operator instead of waiting). Its ABSENCE is what says the provision finished; the only way to find out is to re-call setup_infrastructure or read infrastructure_status's `nextSteps`. An outcome carrying `provisioning`, and a quoteOnly preview, are deliberately NOT recorded against your idempotencyKey — retrying with the same key re-runs the call and finishes the job rather than replaying the unfinished answer. `domains` and `inboxesEach` are the infrastructure you want to HAVE, not an amount to add: each call keeps and resumes what this account already has and buys only the shortfall, so to provision MORE you ask for a LARGER number (domains:2 after a call that provisioned one buys the second; raising inboxesEach tops each domain up). Repeating a call therefore never buys twice, whatever you do with idempotencyKey — resend it, change it, or omit it. The key controls response replay only and has no bearing on what is purchased, so a retry is always safe. A domain this account already registered but that never landed in your account (a prior call that failed after the purchase) is ADOPTED on the retry at zero extra cost rather than bought again. A domain whose DNS setup has not finished yet is recorded and never lost — there is no per-domain DNS field to poll (infrastructure_status reports a domain count, not per-domain detail), so read its `nextSteps` for what to do next, and repeat this same call to converge on the domain and finish its DNS setup. Slot semantics: `domains: N` covers ordinals 0..N-1, and each ordinal fills to its own mailbox count (uniform via `inboxesEach`, or per-ordinal via `distribution` — see below); a repeat call at the SAME `domains` provisions nothing new once every ordinal is satisfied, so reaching ordinal 1 needs `domains:2`, not a second `domains:1` call. Mailbox addresses are DETERMINISTIC — derived from `persona` + ordinal + slot — so keep `persona` EXACTLY as it was on a resume or retry; changing it mid-account does not move existing addresses but does change what a NEW ordinal derives. `distribution` (optional, alternative to `inboxesEach`) names the per-ordinal mailbox count directly — one entry per domain ordinal, e.g. `[3, 2]` for 3 mailboxes on domain 0 and 2 on domain 1 — for a shape `inboxesEach`'s single uniform number cannot express; supply exactly one of the two (an array with `domains` entries, or the uniform count). `registerDomains` is this tenant's opt-in consent to real domain purchases made on the platform's own account (our COGS — your bill is unchanged, mailbox-count-based only); only the operator's own global switch being armed too can ever actually enable it. OMITTING it leaves any consent you previously gave UNCHANGED — pass `false` explicitly to revoke it. A call that omits `registerDomains` (or sends it `false`) on a buy-bearing request (one that needs to purchase a new domain) is refused BEFORE any spend. Once this account has consented at least once, that refusal is a 400 `registrar_optin_missing`: 'registerDomains was not set on this request' — resend the identical call with it set to true to self-correct; this is never an operator escalation. (An account that has never consented, on a platform where domain registration is not yet enabled at all, instead sees the operator-facing 503 `registrar_unarmed` — indistinguishable from the outside except by status code, but the fix is the same: set `registerDomains: true` and retry.) Separately, a `registerDomains:true` call with NO `registrant` anywhere (neither in this request nor persisted from a prior one) fails with a 400 `incomplete_registrant` naming the missing fields — also before any purchase. Fresh candidates are de-duplicated against what this account already owns and checked for availability; if a call needs to buy a domain and no available un-owned candidate exists it fails with a 400 naming that, never a silent repeat purchase (a call that needs to buy nothing is unaffected). `registrant` (a full registrant-of-record object { firstName, lastName, email, phone, addressLine1, city, state, country, postalCode, organization (optional, defaults to brand) }) is OPTIONAL even when `registerDomains` is true whenever a complete registrant is already on file from a prior call — supplying one makes it authoritative for THIS call; omitting it re-uses the persisted one. This platform never invents a domain registrant's legal identity, so a call with no registrant anywhere (neither supplied nor persisted) is rejected naming the missing fields, at or before the actual purchase — never silently. There is NO background retry: a call returning `provisioning` needs the caller to retry it; the platform does not complete it for you on a timer. Every response carries `nextSteps` (see the discriminated `status`/`steps` shape) — the account's own next action, computed fresh each time, so a stalled setup is never silent.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['brand', 'primaryDomain', 'domains', 'persona', 'physicalAddress', 'senderIdentity'], 'properties': {'brand': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'domains': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'persona': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'quoteOnly': {'type': 'boolean', 'default': False}, 'registrant': {'type': 'object', 'required': ['firstName', 'lastName', 'email', 'phone', 'addressLine1', 'city', 'state', 'country', 'postalCode'], 'properties': {'city': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'phone': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'country': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'lastName': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'firstName': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'postalCode': {'type': 'string', 'maxLength': 20, 'minLength': 1}, 'addressLine1': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'organization': {'type': 'string', 'maxLength': 200, 'minLength': 1}}}, 'inboxesEach': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'distribution': {'type': 'array', 'items': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'maxItems': 20, 'minItems': 1}, 'primaryDomain': {'type': 'string', 'maxLength': 253, 'minLength': 3}, 'idempotencyKey': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional idempotency key: resend the SAME key when retrying this call so a dropped-response retry is not applied twice (no duplicate campaign/provision/send).'}, 'senderIdentity': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'physicalAddress': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'registerDomains': {'type': 'boolean'}}}
suppress_lead
Permanently suppress an email address tenant-wide (every current and future campaign) — the manual/free-text 'stop emailing me' path for opt-outs the strict typed-unsubscribe matcher misses. Inputs: email, reason (fixed 'manual' — the only value this tool honestly claims; bounce/complaint/unsubscribe are recorded automatically elsewhere), note (accepted, not persisted). Cancels every pending send + marks every campaign-lead row 'suppressed'. Last-write-wins: re-suppressing a bounce/complaint/unsubscribe row relabels its reason to 'manual'. There is no un-suppress tool.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email'], 'properties': {'note': {'type': 'string', 'maxLength': 2000}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'reason': {'type': 'string', 'const': 'manual', 'default': 'manual'}}}
thread
Full message history for ONE thread. Input: threadId (from inbox). Returns { threadId, campaignId, leadId, leadEmail, mailboxEmail (null before first send), messages[] }, each message { type (sent/reply/bounce/...), ts, messageId, metadata }, oldest first. 404 if unknown. Use inbox to LIST threads; reply to respond; mark/label_thread to triage.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId'], 'properties': {'threadId': {'type': 'string', 'minLength': 1, 'description': 'The thread id, e.g. from inbox() or campaign events.'}}}
update_lead
Record what you learned about a contact (their reply, your triage) as a durable, contact-level disposition — keyed by email, visible across every campaign that lists them. Inputs: email, interestStatus (none|interested|meeting_booked|not_now|not_interested|bad_fit|out_of_office|wrong_person — a server-enforced enum; 'do not contact' is NOT a member, use suppress_lead instead), notes, tags (free-form). A PARTIAL patch — only the fields you pass are changed; at least one of interestStatus/notes/tags is required. Filterable via list_leads.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'maxItems': 50}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'notes': {'type': 'string', 'maxLength': 5000}, 'interestStatus': {'enum': ['none', 'interested', 'meeting_booked', 'not_now', 'not_interested', 'bad_fit', 'out_of_office', 'wrong_person'], 'type': 'string'}}}
Historique
Modifications récentes des outils
Modifié
account
1 October 2026 02:50
Modifié
setup_infrastructure
1 October 2026 02:50
Modifié
account
29 September 2026 02:58
Modifié
launch_campaign
29 September 2026 02:58
Modifié
setup_infrastructure
29 September 2026 02:58
Ajouté
contact_operator
17 September 2026 12:53
Ajouté
ack_message
17 September 2026 12:53
Ajouté
list_messages
17 September 2026 12:53
Ajouté
list_leads
17 September 2026 12:53
Ajouté
update_lead
17 September 2026 12:53
Ajouté
suppress_lead
17 September 2026 12:53
Ajouté
configure_byo_domain
17 September 2026 12:53
Ajouté
get_byo_domains
17 September 2026 12:53
Ajouté
configure_webhook
17 September 2026 12:53
Ajouté
get_webhooks
17 September 2026 12:53
Ajouté
activity
17 September 2026 12:53
Ajouté
list_campaigns
17 September 2026 12:53
Ajouté
label_thread
17 September 2026 12:53
Ajouté
configure_dashboard
17 September 2026 12:53
Ajouté
get_dashboard
17 September 2026 12:53
Ajouté
remove_mailboxes
17 September 2026 12:53
Ajouté
account
17 September 2026 12:53
Ajouté
pause_all
17 September 2026 12:53
Ajouté
pause
17 September 2026 12:53
Ajouté
mark
17 September 2026 12:53
Ajouté
reply
17 September 2026 12:53
Ajouté
thread
17 September 2026 12:53
Ajouté
inbox
17 September 2026 12:53
Ajouté
metrics
17 September 2026 12:53
Ajouté
campaign_results
17 September 2026 12:53
Découvrir
Serveurs MCP similaires
neuron
io.github.conquext/neuron
Operates AI chatbots and messaging workflows across WhatsApp and social channels, including contacts, campaigns, conversations, p…
Emailchaser
com.emailchaser/emailchaser
Manages cold-email campaigns, leads, sender mailboxes, sequences, outreach automation, deliverability, prospect sourcing, webhook…
send16-mcp
io.github.spruikco/send16-mcp
Provides email marketing and transactional messaging tools for contacts, audiences, campaigns, templates, automations, analytics,…
PersuadioAI
com.persuadioai/mcp
Manages leads and outreach campaigns, supports audience selection and message drafting, analyzes responses, and launches SMS camp…
bird
io.usefulapi/bird
Reads Bird workspace email, SMS, and WhatsApp messages and manages contacts and audiences through additive CRM operations.
Smartwebchat
eu.smartwebchat/chatbots
Creates and manages website chatbots, tests responses, diagnoses deployment issues, captures leads, and updates lead statuses.
loops
io.usefulapi/loops
Manages Loops contacts and custom properties, mailing lists, event-triggered automations, and transactional email delivery.
Bottled
email.bottled/bottled
Manages branded domain email, aliases, contacts, drafts, one-to-one messages, campaigns, delivery controls, domain verification, …