Marketing
directmailamerica.com
MCP server for a direct-mail and print service that retrieves product catalogs, generates quotes, and sends letters or postcards via API.
ENDPOINT 1
https://directmailamerica.com/api/mcp
MCP server metadata
- Name
- directmailamerica
- Version
- 1.25.0
DirectMailAmerica provides physical-mail quotes, job submission and status, and Email to Letter inboxes, rules, previews, letterheads and history, plus address-book management, reusable cover sheets, artwork generation/conversion, PDF previews/downloads, workspace settings, billing history, webhooks and Email to Postcard rules, explicitly approved image generation, review and quotes. Public pricing and product information require no account. Private workspace tools require authentication. get_connection_status reports the connected workspace, environment and granted permissions. Individual tool descriptions specify inputs, side effects and charge behavior.
Known tools 71
quote_productHold a 36-hour expanded-product quote using a workspace key, print-ready PDF and 1–100 US recipients.
Inferred read-onlysend_product_quoteWith Bearer auth and confirmed=true, spend workspace credits and release the immutable saved quote.
Inferred read-onlysend_letterSend a standard First-Class letter, Certified Mail, or Express postcard with color included.
Potential side effectscreate_credit_checkoutCreate a Square hosted Payment Link to fund an authenticated workspace.
Potential side effectsget_payment_statusCheck a Square checkout with paymentId and OAuth or a key for its workspace.
Inferred read-onlystart_account_loginReturn public DirectMailAmerica website sign-in, developer settings and MCP documentation links when the user requests account connection help.
Inferred read-onlycheck_email_boxManually check only this workspace's existing inbox now, between scheduled runs.
Inferred read-onlyupdate_email_letter_settingsSet the workspace enabled flag and per-letter/daily/monthly budgets in USD cents plus daily letter limit.
Inferred read-onlysave_email_letter_ruleCreate or replace a mailing rule by id: exact sender/recipient and optional subject text; all specified conditions must match (AND).
Potential side effectsapprove_email_letterApprove printing and mailing of an owned preview using id, exact version, exact cents and confirmMail=true.
Inferred read-onlyupdate_email_letter_pollingAdmin-only: enable/pause global polling or set intervalMinutes from 1 to 1440 (default 10).
Inferred read-onlyhold_email_postcard_reviewAfter the user chooses to review/edit a postcard, pass its id and confirmed:true to hold pending automatic sending.
Potential side effectsdelete_email_postcardAfter explicit confirmation, remove a postcard email from the review queue and delete its stored email/artwork with id and confirmed:true.
Potential side effectsenable_email_to_postcardEnable Email to Postcard intake after the human requests it, with confirmed:true.
Potential side effectsquote_email_postcardPrepare an exact saved Email to Postcard quote from id, attachment index (or generated plus artworkId), edited message and US from/to addresses.
Potential side effectsrevise_email_postcard_quoteExpire an owned, ready Email to Postcard quote using quoteId and confirmed:true so a new edited quote can be prepared.
Potential side effectssave_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.
Potential side effectsdelete_email_postcard_ruleDelete a workspace postcard rule by id after explicit user request with confirmed:true.
Potential side effectsgenerate_email_postcard_artworkGenerate and privately save front artwork for an owned postcard email, including emails without attachments.
Potential side effectsdelete_addressDelete an owned address-book entry after explicit user request with confirmed:true.
Potential side effectsget_workspace_settingsRead profile name, workspace name, default sender and website links for account security, member invitations and API-key management.
Inferred read-onlyupdate_workspace_settingsUpdate the acting member's display name, workspace name and/or default sender.
Potential side effectsget_billing_historyRead the workspace credit ledger with amounts, balances, order references and pagination.
Inferred read-onlyget_job_detailsRead an owned mailing's document metadata, addresses, options, price, receipt and postal tracking.
Inferred read-onlydownload_job_documentDownload an owned job's saved print PDF as an embedded private resource, including Email to Letter document recovery.
Potential side effectsget_product_quoteRecover an owned saved product quote, exact options, price, expiry and order state.
Inferred read-onlysave_cover_sheetCreate or update a reusable cover sheet with every designer option.
Potential side effectsdelete_cover_sheetDelete a saved cover sheet after explicit request with confirmed:true and its current version.
Potential side effectsrender_cover_sheetRender a one-page letter-size cover-sheet PDF with design, sender and recipient.
Inferred read-onlyconvert_postcard_imageConvert imageBase64 (maximum 25 MiB decoded) to print-ready PDF using the website's fitting, orientation and resolution checks.
Inferred read-onlygenerate_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.
Inferred read-onlypreview_letterRender/inspect the exact letter or small postcard PDF and calculate its current price without sending, reserving credits or uploading artwork.
Inferred read-onlyget_webhook_settingsRead the configured workspace webhook URL and latest 50 delivery outcomes.
Inferred read-onlyupdate_webhook_settingsSet or clear the workspace webhook destination after explicit permission to share future mailing/credit events with that HTTPS destination.
Inferred read-onlytest_webhookAfter explicit permission, send one test event to the currently saved webhook destination with confirmed:true.
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.directmailamerica]
url = "https://directmailamerica.com/api/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"directmailamerica": {
"type": "http",
"url": "https://directmailamerica.com/api/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: directmailamerica
Remote MCP URL: https://directmailamerica.com/api/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"directmailamerica": {
"url": "https://directmailamerica.com/api/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"directmailamerica": {
"type": "http",
"url": "https://directmailamerica.com/api/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "directmailamerica",
"transport": "streamable-http",
"url": "https://directmailamerica.com/api/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.