Better Email

Reads the campaign's latest revision, whether the draft holds changes not yet in a revision, and how its latest send performed when the ESP has reported one.

get_campaign_revision_state

What to read before working here: how a build differs from a change, how content goes into a campaign, how to check and report, the organization's tone of voice, and the catalogue of its skills (load one with load_skill when its description fits). Call it once at the start of a task.

get_guidelines

The organization the signed-in user is working in: name, configured languages, and how many campaigns and design systems it has.

get_organization_profile

Returns the pre-flight run for the campaign's LATEST SAVED REVISION — not the current draft. Findings are stale for anything edited since that revision, and there is no run at all until someone creates one. To check work you just did, use run_preflight.

get_preflight_checks

Lists the Recipient Fields and Segments available for block variant conditions on this campaign, or one Segment in full by segmentId. Call it before creating variants or Segments: when the campaign's integration cannot segment, the result has segmentationSupported: false with the reason, and the variant and Segment tools will refuse. Deleting a variant still works, so leftovers can be cleaned up.

get_segmentation_catalog

Inserts a Module as a Block with optional initial values at a 0-based index within a content zone. An index past the end appends the Block. For Campaign builds, supply all known final Block content in values. Omit values only when Design System defaults are intentionally the finished content. Do not insert defaults merely to update the Block immediately afterward. Repeatable settings contain items with a values object, for example values: { cards: [{ values: { title: "First card" } }] }. Insert assigns missing item ids.

insert_block

The organization's sends in a period (sentAfter, sentBefore as ISO 8601), with per-send numbers, totals and average rates. Sort by sentAt (default), openRate or clickRate; rate rankings leave out sends delivered to fewer than 100 recipients unless minDelivered says otherwise. Each send carries the emailName it was exported under; find the campaign with search_campaigns.

list_campaign_performance

Lists the campaign types the user can create a campaign from: kinds of campaign the organization's admins set up, such as a brand or a newsletter. Each fixes the design system, destination, folder and approvers, and may have a naming scheme (namePattern) and instructions. Read the chosen type's instructions before asking the user anything or creating the campaign. When instructionsTruncated is true, call list_campaign_types again with that campaignTypeId for the full text. When required is true, create_campaign is refused; use create_campaign_from_type.

list_campaign_types

Lists recent campaigns the signed-in user can access, newest first. Each result carries the campaign's id for the campaign tools; hasPerformanceData marks campaigns whose send numbers get_campaign_performance can read. Use offset to page.

list_campaigns

Lists a page of Modules currently available for insertion, their compact valueContract, the Block values format, and the Design System content zones they may be inserted into. Use the contract to populate insert_block.values in the same write. Follow pagination.nextOffset while pagination.hasMore is true to browse more Modules. If a large catalogue marks a chosen Module's valueContract as omitted, call this tool again with that componentId for its focused contract.

list_components

Lists design systems. The default purpose "createCampaign" returns published design systems the user may create a campaign from, owned first and then shared (continue with the returned cursor and nextSource while hasMore is true). Each result carries the id create_campaign takes.

list_design_systems

Lists a bounded page of accessible Campaign Folders for choosing a creation or move destination. Use offset to continue while hasMore is true. When truncated is true, some Folders could not be checked, even if hasMore is false. Do not conclude a missing Folder does not exist or substitute the root. Ask the User to choose an available destination or retry later. A null folder means the workspace root.

list_folders

Lists the organization's integrations, each with its destinations (id, name, isDefault). An integration's id is its external id: what context.integration.id holds in design system Liquid, and the integrationId create_campaign and duplicate_campaign take. A destination's id (dst_…) is the destinationId those two take, and it is required when the chosen integration has several destinations.

list_integrations

Lists Recipient Fields valid for subject, preheader, copy, and links that allow personalization. Use insertionSyntax exactly as returned.

list_recipient_fields

Loads the full instructions of one of the organization's skills by its exact name, as listed by get_guidelines. Load a skill when its description matches the task at hand; do not load them all.

load_skill

Moves a Block within or across content zones. Use expectedBlockId from the latest Campaign read to reject a stale positional move.

move_block

Moves one campaign to a folder, or to the workspace root with a null folderId.

move_campaign_to_folder

Shows the user an interactive preview of the campaign: subject and preheader, the rendered email, a desktop/mobile switch, a pre-flight button, and a link to open it in Better Email. Call it as the last step of every build and of any substantial edit, and whenever the user asks to see the campaign; the preview renders in the chat, so do not describe the email or paste its HTML.

preview_campaign

Sets the complete order of non-fallback variants. The fallback variant always remains last.

reorder_block_variants

The way to upload an image file you have on disk, when you can run a shell command: one curl, no base64. Returns a short-lived upload URL and the exact curl line to run; the curl answers with the hosted image url and its dimensions, ready for a Block's image input with update_block. Upload the ORIGINAL file. Never resize, compress or convert it first: Better Email serves every image at the width and device pixel ratio the design system declares for that image input, so a file you shrank first can only come out worse. Crop or recompose only when the design needs a different subject or aspect ratio than the source. The URL is good for 15 minutes, for this campaign and this media type, and can be used once. Use upload_image_from_url when the image is already at a public https URL, and upload_image only when you have no shell.

request_upload_url

Runs the pre-flight checks on the campaign's current draft, including edits not yet in a revision, and returns the findings. It creates no revision. depth 'fast' (the default) runs the deterministic checks in a few seconds: links, images, alt text, unrendered recipient fields, subject and preheader, accessibility and size. depth 'full' also runs the AI copy checks and the rendered-screenshot checks, which take longer. summary.activeFindings counts open findings. summary.unverifiedChecks counts checks that reached no verdict, for example a skipped stage, a timeout or a failed render; those checks report no findings. notEvaluatedCheckIds lists the checks a fast run did not run. status 'not_run' means no checks ran.

run_preflight

Renders the campaign as it stands and returns a desktop or mobile screenshot. Use it after changes to layout, spacing, colour, images, or responsive behaviour.

screenshot_campaign

Renders a public web page and returns a screenshot of it, so you can see a brand's layout, colours, imagery and typography rather than infer them. Use it before building a campaign from a customer's website. The default is the top of the page at desktop width, which is the sharpest view; fullPage captures the whole page but a long one is scaled down and its fine print may not be legible.

screenshot_website

Searches the organization's campaigns and design systems by meaning and by name. Each campaign result carries its id for the campaign tools; hasPerformanceData marks campaigns whose send numbers get_campaign_performance can read.

search_campaigns

Sets whether the fallback/everybody-else variant is hidden. This is an absolute set, never a toggle.

set_block_fallback_hidden

Updates a non-fallback block variant's audience condition and/or display name.

set_block_variant_condition

Sets the Campaign subject line and/or preheader. Omitted fields are preserved.

set_subject_preheader

Updates only the supplied values on a Block, Block variant, or global Campaign settings. Values are validated against the Design System before writing. A repeatable setting is sent as the full array of items, and every item needs an id and a values object, for example values: { cards: [{ id: "card-1", values: { title: "Updated card" } }] }. An item with the id of an existing item keeps every input you leave out. An item you leave out of the array is removed. An item with a new, non-empty id is added.

update_block

Uploads SVG markup you wrote into Better Email storage, for a shape that does not exist as a file yet. Converts it to PNG by default, which is what an image laid out normally needs since email clients do not render SVG reliably; pass convertSvg false to keep the vector, which is required for an imgTag mask_url asset because a vector mask stays sharp at every frame size. A preserved vector reports no dimensions. Use upload_image_from_url instead when the artwork already exists at a URL.

upload_svg

Downloads an approved non-image asset URL into Better Email storage and returns its hosted URL and media type.

upload_asset

Uploads a small image you hold as bytes, for when you have no shell. Send the bytes base64 in `base64` with their media type, up to 10 MB, and it returns the hosted URL and dimensions, ready for a Block's image input. Prefer request_upload_url whenever you can run a shell command: base64 in a tool call costs you output tokens for every byte of the file, and a megabyte takes minutes. Use upload_image_from_url when the image is already at a public https URL. Send the ORIGINAL file: never resize, compress or convert it to make it fit this call, because Better Email serves every image at the width and device pixel ratio the design system declares for that image input.

upload_image

Downloads an image that is already at a public https URL into Better Email storage and returns the hosted URL and dimensions, ready for an image input. An SVG is converted to PNG unless convertSvg is false. Point it at the ORIGINAL image, the largest the source offers: never resize, compress or convert it first, because Better Email serves every image at the width and device pixel ratio the design system declares for that image input. For a file on disk use request_upload_url when you can run a shell command, or upload_image when you cannot.

upload_image_from_url