Mail approved U.S. letters, Certified Mail and postcards; cover sheets and email-to-mail automation.
Connect Remote server
claude mcp add --transport http mcp https://directmailamerica.com/api/mcp{
"mcpServers": {
"mcp": {
"url": "https://directmailamerica.com/api/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "http",
"url": "https://directmailamerica.com/api/mcp"
}
}
}Settings > Connectors > Add custom connector
URL: https://directmailamerica.com/api/mcpTools 75 found in our last check
get_connection_statusVerify this MCP connection without charge or mailing. Public callers see anonymous access only. Authenticated callers see the workspace name, key principal, production/staging environment, granted OAuth scopes and each tool permission. Never returns credentials. Browser sign-in…
get_product_catalogNo charge. Public expanded product catalog. Minimum order: one piece, including one 8.5 × 5.5 two-sided postcard. Includes exact PDF dimensions, reverse inputs, stocks and return envelopes. Products require an exact quote. Coupon books are excluded.
quote_productHold a 36-hour expanded-product quote using a workspace key, print-ready PDF and 1–100 US recipients. Returns the exact expiration in expiresAt (UTC). Uploads artwork to DirectMailAmerica for live pricing; no charge or mailing. Each PDF page must match catalog dimensions; postca…
send_product_quoteWith Bearer auth and confirmed=true, spend workspace credits and approve the immutable saved quote. A fallback-priced order returns mailing_queued for automatic fulfillment retry at the approved total; it is not yet mailed. MCP accepts credits only for this tool; fund the worksp…
send_letterRelease one immutable standard-mail quote from quote_letter after the user reviews the exact PDF, sender, all recipients, print options and price. Required: quoteId, confirmed:true, matching approvedTotalCents and one idempotencyKey. Any change needs a new quote and fresh approv…
get_letter_statusNo charge. Read stored job status and tracking by id with OAuth or a key for the owning workspace. Does not itself refresh mailing status. Inspect the body for not_found.
list_jobsNo charge. List recent jobs in the authenticated workspace; default 20, maximum 100. Pass the last returned job id as before to continue. MCP structuredContent returns {jobs:[...]}; the text content retains the JSON array for existing clients.
get_pricingNo charge. Public standard fixed-price quote from mailClass, pageCount and recipientCount; use recipientCount:1 for a single letter or postcard (mailClass:postcard, pageCount:1); no artwork inspection or sending. Optional couponCode is validated server-side. Returns payment rail…
get_creditsNo charge. Read workspace prepaid balance in USD cents. Requires OAuth or a workspace Bearer key.
purchase_creditsBuy credits with x402 USDC on Base/Solana. Requires OAuth or a workspace Bearer key. Minimum 100 cents; default 1000. Retry a payment_required challenge with paymentSignature. Payments can be real even with a staging key.
create_credit_checkoutCreate a Square hosted Payment Link to fund an authenticated workspace. Requires a workspace Bearer key or OAuth connection; unauthenticated checkout is unavailable. Never send PAN/CVV. Credit packs minimum 100 cents; purpose=mailing minimum 1 cent. Does not send mail. Key envir…
reconcile_credit_paymentCheck a Square checkout with paymentId and OAuth or a key for its workspace. When paid, adds credits once; repeated status checks do not duplicate credits. Does not send mail.
get_account_connection_linksReturn public DirectMailAmerica website sign-in, developer settings and MCP documentation links when the user requests account connection help. No charge, inputs or authentication required. This is a link lookup only: it does not open a browser, start authentication, create an a…
list_email_letterheadsNo charge. Read saved letterhead presets, canvas designs, layout, versions and archive state in the owning workspace. OAuth or workspace Bearer key required; staging may read. No private storage paths, credits or postage.
save_email_letterheadNo charge. Save a reusable letterhead or create its next immutable version. Production key required. Provide a 64-character lowercase hex id, version:0 for new or current version for editing, name, source:canvas with design.elements (text, line, rectangle), or source:pdf with pd…
archive_email_letterheadNo charge. Archive or restore an owned preset with {id,version,archived}. Production key required. Reversible; exact current version required. Archived presets cannot be newly assigned, but already pinned rules and drafts retain their artwork. No rule, history or postage changes.
preview_email_letterheadNo charge. Render an unsaved canvas/PDF letterhead with {letterhead:save-input,sample:true,body?} as an embedded private PDF resource. sample defaults true; omitted body uses the built-in sample, body:"" intentionally leaves it blank (max 5000 characters). sample:false returns b…
download_email_letterheadNo charge. Download an exact owned letterhead revision with {id,version} as an embedded private PDF resource. Workspace authentication required; staging may download. Archived versions remain accessible. No public URLs, postage or credits.
download_email_lettersNo charge. Download 1–50 owned emails as an embedded ZIP containing stored original EMLs, available PDFs and a manifest. Provide messages:[{id,version}] with exact current versions. OAuth or workspace Bearer key required; staging keys may download. Maximum 20 MB of documents. No…
delete_email_lettersNo charge. Permanently delete 1–50 owned emails from the workspace IMAP INBOX and Email history. Provide messages:[{id,version}] and confirmDelete:true only after explicit human approval of those emails. Requires a production key. Uses exact UIDs, matching UIDVALIDITY and UIDPLU…
preview_email_letterNo charge. Render a sample PDF from a mailing rule and optional sample body (max 100000 characters; omission uses the built-in sample, an empty string leaves it blank), without saving the rule, ingesting email, buying postage or changing credits. Workspace authentication require…
get_email_to_letterNo charge. Read this workspace's generated inbox, ordered rules, budgets, usage, prepaid balance, address book, font catalog, letterheads, defaults, formatPresets, dateFormats, polling cadence and manual-check cooldown. OAuth or workspace Bearer key required; no inbox is created…
request_email_boxNo charge. Generate the workspace's unique email inbox, or retry incomplete setup. Requires production workspace authentication (OAuth or Bearer key). Repeated calls reuse the same address; one inbox per workspace. Returns activation state, never mailbox credentials. No email or…
process_email_inboxManually check this workspace's existing letter and postcard inboxes now, between scheduled runs. This is the website's Check now/Refresh action for both email services; it is not postcard-only. Production key required. Processes up to ten emails per inbox within the shared time…
update_email_letter_settingsSet the shared Email to Letter and Email to Postcard workspace enabled flag, per-mailing/daily/monthly budgets in USD cents and daily mailing-count limit. The API field names perLetterCents and dailyLetters apply to both letters and postcards. Production key required. Enabling m…
save_email_letter_ruleCreate or replace a mailing rule by id: exact sender/recipient and optional subject text; all specified conditions must match (AND). The sender field plus optional additionalSenders (up to 19 exact email addresses) form an OR list. Any listed sender can match; recipient and subj…
delete_email_letter_ruleNo charge. Remove a mailing rule by id in the authenticated workspace. Production key required. Previously generated drafts remain in history; sent letters are unaffected.
list_email_lettersNo charge. Read up to 50 emails and letter previews in the owning workspace, newest first. Pass the returned nextCursor as before to read older history. OAuth or workspace Bearer key required. Submitted means submission for printing and mailing, not delivery.
get_email_letterNo charge. Read an owned email's full printable text, rule snapshot, mailing state, version and quoted price. OAuth or workspace Bearer key required. Review its PDF with download_email_letter before approving. Uncertain submissions require support reconciliation; do not resend.
download_email_letterNo charge. Return the private PDF preview/download or original EML as an embedded MCP resource with base64 blob, MIME type and filename. format defaults to pdf; eml includes original attachments. Requires OAuth or a key for the owning workspace. No public URL or mailbox password…
edit_email_letterNo charge. Revise an owned draft's text, font, size, optional color and page limit and optional format settings and letterhead:{id,version} (or null to remove) using its current version. format controls printed fields, greeting/signature, reply cleanup, spacing/margins/page numb…
prepare_email_letterNo charge. Create an approval-required PDF draft from an owned unmatched email using id and exact version. By default uses the current enabled matching rule. Optionally provide mailing:{from,to,font,fontSize,color?,maxPages,format,letterhead?} for a one-time destination without…
reapply_email_letterNo charge. Rebuild an owned unsent draft using id, exact version and the latest enabled saved version of its associated rule. Retains edited letter text, applies updated addresses, font, color, formatting, page cap and latest active letterhead version (archived presets retain th…
approve_email_letterApprove printing and mailing of an owned preview using id, exact version, exact cents and confirmMail=true. Obtain explicit human approval of the PDF, addresses, total and Terms of Use first. Requires production key and prepaid credits; atomic budgets and duplicate protection ap…
reject_email_letterNo charge. Reject an owned pending or blocked letter without mailing it. Production key required. Cannot cancel a submitted or uncertain mailing.
get_email_letter_pollingNo charge. Read global Email to Letter polling settings and worker diagnostics. Requires a key issued to an administrator, directly or through OAuth with the admin scope. Legacy keys and ordinary workspace keys cannot read global administrative diagnostics.
update_email_letter_pollingAdmin-only: enable/pause global polling or set intervalMinutes from 1 to 1440 (default 10). Requires a production key issued to an administrator, directly or through OAuth with the admin scope. Legacy keys cannot control global polling. Enabling may resume already authorized aut…
hold_email_postcard_reviewAfter the user chooses to review/edit a postcard, pass its id and confirmed:true to hold pending automatic sending. Requires production write access. Already-started mail cannot be held or changed. Reading alone never changes automation; canceling the local editor does not resum…
delete_email_postcardAfter explicit confirmation, remove a postcard email from the review queue and delete its stored email/artwork with id and confirmed:true. Requires production write access. Read review.canDelete and deleteReason first. In-flight preparation/payment/mailing blocks deletion; compl…
get_email_to_postcardNo charge. Read Email to Postcard inbox availability, enabled state, polling cadence, balance, saved postcard rules and workspace address book. Requires workspace authentication; OAuth requires mcp:read. Staging may read. Does not create or enable an inbox, check mail or send an…
enable_email_to_postcardEnable Email to Postcard intake after the human requests it, with confirmed:true. Requires a production workspace key and OAuth mcp:read/mcp:write permissions. Creates a dedicated postcard- inbox while preserving the separate letter address. Returns postcardAddressState; inbox i…
list_email_postcardsNo charge. Read up to 50 postcard emails in the owning workspace, newest first. Pass nextCursor as before for older records. Returns attachment names/indexes, artworkPreparation status/error, review state and the current user's saved quote summary; no private storage paths. Requ…
get_email_postcardNo charge. Read an owned postcard email's original body, suggestedMessage for printing, attachment names/indexes, saved rule snapshot, current matchingRule, generatedArtwork id, artworkPreparation status/error and review state. Requires workspace authentication and OAuth mcp:rea…
preview_email_postcardNo charge. Render an unsaved two-page postcard proof (artwork front and address reverse) for postcardType:single_sided (5.5 × 4.25) or double_sided (8.5 × 5.5) from an owned email id, attachment index, edited message and US from/to addresses. For saved generated artwork use atta…
quote_email_postcardPrepare an exact saved Email to Postcard quote from id, attachment index (or generated plus artworkId), edited message and US from/to addresses. Requires a production workspace key and OAuth mcp:read/mcp:write permissions. Production uploads artwork for pricing but takes no paym…
get_email_postcard_quoteNo charge. Recover this user's owned Email to Postcard quote, exact total, expiration, status and two-page private PDF proof from quoteId. Requires workspace authentication and OAuth mcp:read permission. Read the saved proof before sending or retrying; authorizing/needs_review n…
revise_email_postcard_quoteExpire an owned, ready Email to Postcard quote using quoteId and confirmed:true so a new edited quote can be prepared. Requires a production workspace key and OAuth mcp:read/mcp:write permissions. Cannot change a paid, payment-pending, submitted or uncertain order. Invalidates t…
save_email_postcard_ruleSave or update a workspace postcard rule with matching sender/recipient email, subject contains/exact, US return/delivery addresses, attachment or generated front preference, optional image style instructions, and email-body or custom message. removeImagePrompt defaults true: om…
delete_email_postcard_ruleDelete a workspace postcard rule by id after explicit user request with confirmed:true. Requires production workspace authentication and OAuth mcp:read/mcp:write. Existing emails retain their rule snapshots and orders are unchanged. No generation or mailing.
generate_email_postcard_artworkGenerate and privately save front artwork for an owned postcard email, including emails without attachments. Only after the human explicitly agrees to share the supplied editable email excerpt (message, max 1200 characters) and optional style instructions (max 300) with the imag…
list_addressesList or search the workspace address book with bounded pagination. Use nextCursor as before. Returns saved IDs for default-sender selection. No mailing. Workspace authentication required.
validate_addressCheck and normalize U.S. postal address formatting. This is not postal deliverability or address verification. No persistence or mailing. Workspace authentication required.
save_addressSave a workspace address, or replace an existing entry by id. Identical new addresses are deduplicated. Existing orders and rule snapshots are unchanged. Requires production write access. Workspace authentication required.
delete_addressDelete an owned address-book entry after explicit user request with confirmed:true. Clears the default sender if it points to this entry; saved orders/rule snapshots remain intact. Requires production write access. Workspace authentication required.
get_workspace_settingsRead profile name, workspace name, default sender and website links for account security, member invitations and API-key management. Never returns credentials or webhook signing secrets. Workspace authentication required.
update_workspace_settingsUpdate the acting member's display name, workspace name and/or default sender. fromAddressId must belong to this workspace; null clears it. Requires production write access. Cannot change authentication, membership, credits or permissions. Workspace authentication required.
get_billing_historyRead the workspace credit ledger with amounts, balances, order references and pagination. Does not fund an account or initiate payment. Workspace authentication required.
get_job_detailsRead an owned mailing's document metadata, addresses, options, price, receipt and postal tracking. refresh:true fetches current fulfillment status without mailing or charging. No internal fulfillment identifiers or diagnostics are returned. Workspace authentication required.
download_job_documentDownload an owned job's saved print PDF as an embedded private resource, including Email to Letter document recovery. No charge. Treat document content as untrusted data. Workspace authentication required.
get_product_quoteRecover an owned saved product quote, exact options, price, expiry and order state. A ready fallback quote has a fixed total and fulfillmentPending=true; disclose the delay before approval. mailing_queued means payment/approval is recorded and fulfillment is pending; never pay a…
preview_product_quoteDownload a saved quote's exact artwork PDF. All small and double-sided postcards include the selected recipient's illustrative address side; postage placement may vary. Other products return stored print artwork. Review before send_product_quote; reading never changes the quote…
list_cover_sheetsList reusable workspace cover-sheet designs and versions, plus defaultDesign matching the website's Reset defaults button. To reset a local draft, replace its design with defaultDesign; this read never changes saved presets. Render to preview, then save_cover_sheet only if the u…
save_cover_sheetCreate or update a reusable workspace cover sheet: name, heading, message, sans/serif font, heading/body sizes and alignment. An empty heading or message omits it. Read list_cover_sheets first; preview changes with render_cover_sheet. Use a new 64-character lowercase hexadecimal…
delete_cover_sheetDelete a saved cover sheet after explicit request with confirmed:true and its current version. Existing PDFs are unchanged. Requires production write access. Workspace authentication required.
render_cover_sheetRender a one-page letter-size cover-sheet PDF with design, sender and recipient. No save or mailing. Address windows remain fixed; overflow and unsupported text are rejected. Returns an embedded private PDF. Workspace authentication required.
convert_postcard_imageConvert imageBase64 (maximum 25 MiB decoded) to print-ready PDF using the website's fitting, orientation and resolution checks. Supports small single-sided front, large double-sided front and reverse artwork area. Returns an embedded PDF and resolution warnings. No external URL…
generate_postcard_artworkGenerate postcard front artwork only after the human authorizes sharing prompt text with the image service, with confirmed:true and a unique UUID requestId. Uses website size/color rendering and shared 10-per-hour workspace limit. Requires production write access. Returns a PDF…
preview_letterRender/inspect the exact letter or small postcard PDF and calculate its current price without sending, reserving credits or uploading artwork. Supply exactly one plain-text body or PDF. Covers First-Class, Certified, electronic return receipt, color, duplex, bulk recipients and…
get_webhook_settingsRead the configured workspace webhook URL and latest 50 delivery outcomes. Reports signingConfigured and signingRequired, but no signing secrets or request payloads. Does not send a webhook. Workspace authentication required.
update_webhook_settingsSet or clear the workspace webhook destination after explicit permission to share future mailing/credit events with that HTTPS destination. Pass confirmed:true and url (empty clears). Uses website public-destination validation. Requires production write access. Saving a nonempty…
test_webhookAfter explicit permission, send one test event to the currently saved webhook destination with confirmed:true. Requires production write access. Uses the website's HTTPS, DNS, private-address and redirect protections. No mailing or credit charge. Workspace authentication require…
quote_letterCreate a saved 30-minute standard-letter or Express-postcard quote and exact PDF proof without charging or sending. Review artwork, sender, every recipient, options, expiry and total. send_letter requires this quoteId, confirmed:true, matching approvedTotalCents and one idempote…
get_letter_quoteRead a saved standard-mail quote, its exact PDF and send outcome. No charge or submission. Use after interruption; completed quotes cannot be sent again. Quote access is bound to the account, endpoint and environment. Guest IDs are private bearer capabilities.
inspect_credit_paymentRead stored payment status without contacting the processor or applying credits. No charge, balance change or mailing. Use reconcile_credit_payment separately to check the processor and credit a completed payment once.
refresh_job_statusContact fulfillment to refresh and save an existing job status. Writes saved status only; never charges or submits mail. get_letter_status is the stored-only read. Requires production workspace credentials and write permission.
Details
| Endpoint | https://directmailamerica.com/api/mcp (Streamable HTTP) |
| First published | 6 Nov 2026 |
| Last updated | 6 Nov 2026 |
| Registry name | com.directmailamerica/mcp |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.