The Direct Mail MCP Server

One comprehensive briefing on the account: plan tier, credit balance, send history, top/bottom performing creatives and messages, mailing lists, and active campaigns.

QR scan rates, gift card redemptions, and spend breakdowns by design, message, mailer type, mailing list, or campaign.

Proven direct mail plays, industry response benchmarks, and follow-up sequences for strategy consultations.

Account details, plan, default and saved return addresses, default postage class, credit balance, test mode status, and active MCP spending permissions.

Your sub-accounts, enabling the assistant to act on behalf of specific clients or teams via sub_account_id.

Available realistic handwriting styles, fonts, and sample preview images.

Browse saved front design image templates.

Save a new front design from an image URL, or a dynamic personalized design that merges recipient variables.

Rename or replace the source artwork for an existing front design template.

Turn the QR code printed in an uploaded front design into a tracked thanks.io code, so every scan is counted and lands on the link you choose.

Your saved messages with handwriting style, font size, and pen color configurations.

Save a message with custom handwriting styling, or a PDF document to mail as a letter.

Modify text, handwriting settings, or layout of a saved message template.

Supported gift card brands (Amazon, Starbucks, Home Depot, etc.) available to pair with mailers.

Your creatives: saved front designs paired with message templates, ready to send by creative_id.

Fetch a complete creative profile and verify whether it is ready and valid to send.

Pair a front design template with a message template into an instantly reusable creative unit.

Rename, archive/hide, or swap the front design or message of an existing creative.

Generate a custom, professional mailer front design from a text description. Free of charge, completes in 1-3 minutes.

Check generative design rendering progress and retrieve full-resolution proof images.

List generated Studio designs sorted newest first.

Request natural-language visual edits to an existing Studio design (e.g., 'make headline larger', 'add discount banner').

Update title, QR code URL destination, or target mailer format for a Studio design.

Commit an AI Studio design to your permanent template library and pair it with a message in your creatives catalog.

View all saved recipient mailing lists and current subscriber counts.

Create a new empty recipient mailing list.

Add a single recipient to a mailing list. Free with full address; triggers address lookup if only email is supplied.

Batch import recipients into a mailing list at once.

Inspect recipients on a list, including USPS CASS address deliverability status.

Find the intent topics to target: consumers or businesses who have recently researched a product or service online, searched by keyword. Free.

Look up the ZIP codes, cities, counties, and states to target by the place names you give it. Free.

Count how many people match a topic, place, and demographic search before buying anything. Free, limited per hour.

Get a preview's result: how many people match, the price per lead, and up to five masked sample leads.

Buy up to 100 leads once and add them to a new or existing mailing list, at $0.10 for each lead added. People already on the list are skipped and not charged.

Start a lead feed that adds new matching people to a mailing list every day or every week, at $0.10 per lead added, up to a per-run cap you set.

List your lead feeds with each one's status, cadence, per-run cap, leads added so far, next run, and the list it fills.

Pause, resume, or stop a lead feed, or change how often it runs and how many leads each run may add. Pausing is always allowed.

Render high-res proof images and compute an exact total price quote with postage, without charging anything. Free with full addresses.

Supports postage_class (first_class, standard), return_address_id, realism, and email_lookup: false.

Send 4x6, 6x9, or 6x11 glossy postcards with handwriting styling and dynamic QR codes.

Send personalized printed letters in standard windowed envelopes.

Send letters in realistic handwritten, windowless envelopes for maximum open rates.

Send folded premium notecards inside handwritten envelopes.

Send MagnaCards featuring an integrated punch-out refrigerator magnet.

Send physical gift cards (Amazon, Starbucks, Home Depot, etc.). Billed for printing/postage plus the exact face value of each card.

Browse historical and active orders with live fulfillment status, total spend, and QR scan counts.

Fetch live USPS tracking, proof scans, delivery confirmations, return status, and QR scans for 1 to 50 orders simultaneously.

Aggregate spend, delivery counts, scans, and redemptions over a custom date range or campaign filter.

Retrieve the exact list of recipients actually mailed by an order for CRM auditing and reconciliation.

Check whether a specific individual, email, or street address was ever mailed by your account, and by which order.

Cancel an order while it is still under the pre-print review window. Orders that have started printing cannot be cancelled.

List registered webhook endpoints, delivery history, and plan feature allowances.

Register an HTTP endpoint for real-time events: order status changes, USPS deliveries, QR scans, and Lead Board stage transitions.

Update webhook target URL, subscribed events, Lead Board stage filters, or HMAC secrets.

Deactivate and delete an existing webhook listener.

List automated recurring campaigns, trigger schedules, and active/paused statuses.

Create an automated recurring campaign against a mailing list. Newly created campaigns start safely paused.

Activate or pause a recurring campaign. Activating authorizes recurring sends on schedule. Pausing is always permitted.