DirectMailAmerica — Full

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "directmailamerica": {
      "type": "http",
      "url": "https://directmailamerica.com/api/mcp"
    }
  }
}

75 tools

• get_connection_status

  Verify 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_catalog

  No 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_product

  Hold 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…

• send_product_quote

  With 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…

• send_letter

  Release 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…

• get_letter_status

  No 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_jobs

  No 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_pricing

  No 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…

• get_credits

  No charge. Read workspace prepaid balance in USD cents. Requires OAuth or a workspace Bearer key.

• purchase_credits

  Buy 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_checkout

  Create 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…

• reconcile_credit_payment

  Check 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_links

  Return 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…

• list_email_letterheads

  No 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_letterhead

  No 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…

• archive_email_letterhead

  No 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_letterhead

  No 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…

• download_email_letterhead

  No 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_letters

  No 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_letters

  No 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…

• preview_email_letter

  No 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…

• get_email_to_letter

  No 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_box

  No 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_inbox

  Manually 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_settings

  Set 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…

• save_email_letter_rule

  Create 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…

• delete_email_letter_rule

  No 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_letters

  No 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_letter

  No 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_letter

  No 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_letter

  No 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…

• prepare_email_letter

  No 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_letter

  No 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…

• approve_email_letter

  Approve 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…

• reject_email_letter

  No charge. Reject an owned pending or blocked letter without mailing it. Production key required. Cannot cancel a submitted or uncertain mailing.

• get_email_letter_polling

  No 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_polling

  Admin-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…

• hold_email_postcard_review

  After 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…

• delete_email_postcard

  After 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…

• get_email_to_postcard

  No 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…

Security scan

Recent checks