DirectMailAmerica — Full
REMOTE · DIRECTMAILAMERICA.COM
Mail approved U.S. letters, Certified Mail and postcards; cover sheets and email-to-mail automation.
Available components
Last scanned (4 hours ago)
Scores higher than 54% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Documents and Files
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security63
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (quote_product). See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability64
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 9540 tokens (~127/item across 75 items; 75 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management42
- Stability check failed: schema churn in the 14 days we've observed: 3 tool removals, 1 breaking changes, 0 auth/transport breaks, 7 additions. See how to fix → Fail
Tool Coverage76
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 16% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 8 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 76 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- Tool “quote_product” rewrote its description, which is the text the model reads security
- Tool “get_product_quote” rewrote its description, which is the text the model reads security
- Tool “send_letter” rewrote its description, which is the text the model reads security
- Server version: 2.1.0 → 2.3.0 functional
- 3 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 32 to 35.
- 1 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 25 to 28.
- 31 Oct 26 0
- Tool “check_email_box” was removed ▼ security
- Tool “get_payment_status” was removed ▼ security
- New tool “process_email_inbox”, which the server declares destructive security
- New tool “quote_letter”, which the server declares destructive security
- New tool “reconcile_credit_payment”, which the server declares destructive security
- New tool “refresh_job_status”, which the server declares destructive security
- Tool “save_cover_sheet” rewrote its description, which is the text the model reads security
- Tool “send_letter” rewrote its description, which is the text the model reads security
- “send_letter” added a required parameter “approvedTotalCents”, so existing callers break ▼ functional
- “send_letter” added a required parameter “confirmed”, so existing callers break ▼ functional
- “send_letter” added a required parameter “quoteId”, so existing callers break ▼ functional
- “send_letter” made “idempotencyKey” required, so existing callers break ▼ functional
- Tool “approve_email_letter” now declares an output schema ▲ functional
- Tool “archive_email_letterhead” now declares an output schema ▲ functional
- Tool “convert_postcard_image” now declares an output schema ▲ functional
- Tool “create_credit_checkout” now declares an output schema ▲ functional
- Tool “delete_address” now declares an output schema ▲ functional
- Tool “delete_cover_sheet” now declares an output schema ▲ functional
- Tool “delete_email_letter_rule” now declares an output schema ▲ functional
- Tool “delete_email_letters” now declares an output schema ▲ functional
- Tool “delete_email_postcard” now declares an output schema ▲ functional
- Tool “delete_email_postcard_rule” now declares an output schema ▲ functional
- Tool “download_email_letter” now declares an output schema ▲ functional
- Tool “download_email_letterhead” now declares an output schema ▲ functional
- Tool “download_email_letters” now declares an output schema ▲ functional
- Tool “download_job_document” now declares an output schema ▲ functional
- Tool “edit_email_letter” now declares an output schema ▲ functional
- Tool “enable_email_to_postcard” now declares an output schema ▲ functional
- Tool “generate_email_postcard_artwork” now declares an output schema ▲ functional
- Tool “generate_postcard_artwork” now declares an output schema ▲ functional
- Tool “get_account_connection_links” now declares an output schema ▲ functional
- Tool “get_billing_history” now declares an output schema ▲ functional
- Tool “get_connection_status” now declares an output schema ▲ functional
- Tool “get_credits” now declares an output schema ▲ functional
- Tool “get_email_letter” now declares an output schema ▲ functional
- Tool “get_email_letter_polling” now declares an output schema ▲ functional
- Tool “get_email_postcard” now declares an output schema ▲ functional
- Tool “get_email_postcard_quote” now declares an output schema ▲ functional
- Tool “get_email_to_letter” now declares an output schema ▲ functional
- Tool “get_email_to_postcard” now declares an output schema ▲ functional
- Tool “get_job_details” now declares an output schema ▲ functional
- Tool “get_letter_status” now declares an output schema ▲ functional
- Tool “get_pricing” now declares an output schema ▲ functional
- Tool “get_product_catalog” now declares an output schema ▲ functional
- Tool “get_product_quote” now declares an output schema ▲ functional
- Tool “get_webhook_settings” now declares an output schema ▲ functional
- Tool “get_workspace_settings” now declares an output schema ▲ functional
- Tool “hold_email_postcard_review” now declares an output schema ▲ functional
- Tool “list_addresses” now declares an output schema ▲ functional
- Tool “list_cover_sheets” now declares an output schema ▲ functional
- Tool “list_email_letterheads” now declares an output schema ▲ functional
- Tool “list_email_letters” now declares an output schema ▲ functional
- Tool “list_email_postcards” now declares an output schema ▲ functional
- Tool “list_jobs” now declares an output schema ▲ functional
- Tool “prepare_email_letter” now declares an output schema ▲ functional
- Tool “preview_email_letter” now declares an output schema ▲ functional
- Tool “preview_email_letterhead” now declares an output schema ▲ functional
- Tool “preview_email_postcard” now declares an output schema ▲ functional
- Tool “preview_letter” now declares an output schema ▲ functional
- Tool “preview_product_quote” now declares an output schema ▲ functional
- Tool “purchase_credits” now declares an output schema ▲ functional
- Tool “quote_email_postcard” now declares an output schema ▲ functional
- Tool “quote_product” now declares an output schema ▲ functional
- Tool “reapply_email_letter” now declares an output schema ▲ functional
- Tool “reject_email_letter” now declares an output schema ▲ functional
- Tool “render_cover_sheet” now declares an output schema ▲ functional
- Tool “request_email_box” now declares an output schema ▲ functional
- Tool “revise_email_postcard_quote” now declares an output schema ▲ functional
- Tool “save_address” now declares an output schema ▲ functional
- Tool “save_cover_sheet” now declares an output schema ▲ functional
- Tool “save_email_letter_rule” now declares an output schema ▲ functional
- Tool “save_email_letterhead” now declares an output schema ▲ functional
- Tool “save_email_postcard_rule” now declares an output schema ▲ functional
- Tool “send_letter” now declares an output schema ▲ functional
- Tool “send_product_quote” now declares an output schema ▲ functional
- Tool “test_webhook” now declares an output schema ▲ functional
- Tool “update_email_letter_polling” now declares an output schema ▲ functional
- Tool “update_email_letter_settings” now declares an output schema ▲ functional
- Tool “update_webhook_settings” now declares an output schema ▲ functional
- Tool “update_workspace_settings” now declares an output schema ▲ functional
- Tool “validate_address” now declares an output schema ▲ functional
- First check of Tool coverage: 100 functional
- Server version: 2.0.0 → 2.1.0 functional
- Server version: 1.26.3 → 2.0.0 functional
- New tool “get_letter_quote” functional
- New tool “inspect_credit_payment” functional
- “send_letter” made “from” optional cosmetic
- “send_letter” made “recipients” optional cosmetic
- 29 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 19 to 22.
- 27 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 12 to 15.
- 25 Oct 26 0
- Stability: 0.07 → fail ▼ security
- Tool “start_account_login” was removed ▼ security
- Server version: 1.26.2 → 1.26.3 functional
- New tool “get_account_connection_links” functional
- 24 Oct 26 +1
- Tool “create_credit_checkout” is now declared destructive security
- Tool “enable_email_to_postcard” is now declared destructive security
- Tool “generate_postcard_artwork” is now declared destructive security
- Tool “get_job_details” is now declared destructive security
- Tool “get_payment_status” is now declared destructive security
- Tool “prepare_email_letter” is now declared destructive security
- Tool “quote_product” is now declared destructive security
- Tool “request_email_box” is now declared destructive security
- Tool “test_webhook” is now declared destructive security
- Server version: 1.26.1 → 1.26.2 functional
- Tool “approve_email_letter” changed its title: Approve Email Letter cosmetic
- Tool “archive_email_letterhead” changed its title: Archive Email Letterhead cosmetic
- Tool “check_email_box” changed its title: Check Email Box cosmetic
- Tool “convert_postcard_image” changed its title: Convert Postcard Image cosmetic
- Tool “create_credit_checkout” changed its title: Create Credit Checkout cosmetic
- Tool “delete_address” changed its title: Delete Address cosmetic
- Tool “delete_cover_sheet” changed its title: Delete Cover Sheet cosmetic
- Tool “delete_email_letter_rule” changed its title: Delete Email Letter Rule cosmetic
- Tool “delete_email_letters” changed its title: Delete Email Letters cosmetic
- Tool “delete_email_postcard” changed its title: Delete Email Postcard cosmetic
- Tool “delete_email_postcard_rule” changed its title: Delete Email Postcard Rule cosmetic
- Tool “download_email_letter” changed its title: Download Email Letter cosmetic
- Tool “download_email_letterhead” changed its title: Download Email Letterhead cosmetic
- Tool “download_email_letters” changed its title: Download Email Letters cosmetic
- Tool “download_job_document” changed its title: Download Job Document cosmetic
- Tool “edit_email_letter” changed its title: Edit Email Letter cosmetic
- Tool “enable_email_to_postcard” changed its title: Enable Email To Postcard cosmetic
- Tool “generate_email_postcard_artwork” changed its title: Generate Email Postcard Artwork cosmetic
- Tool “generate_postcard_artwork” changed its title: Generate Postcard Artwork cosmetic
- Tool “get_billing_history” changed its title: Get Billing History cosmetic
- Tool “get_connection_status” changed its title: Get Connection Status cosmetic
- Tool “get_credits” changed its title: Get Credits cosmetic
- Tool “get_email_letter” changed its title: Get Email Letter cosmetic
- Tool “get_email_letter_polling” changed its title: Get Email Letter Polling cosmetic
- Tool “get_email_postcard” changed its title: Get Email Postcard cosmetic
- Tool “get_email_postcard_quote” changed its title: Get Email Postcard Quote cosmetic
- Tool “get_email_to_letter” changed its title: Get Email To Letter cosmetic
- Tool “get_email_to_postcard” changed its title: Get Email To Postcard cosmetic
- Tool “get_job_details” changed its title: Get Job Details cosmetic
- Tool “get_letter_status” changed its title: Get Letter Status cosmetic
- Tool “get_payment_status” changed its title: Get Payment Status cosmetic
- Tool “get_pricing” changed its title: Get Pricing cosmetic
- Tool “get_product_catalog” changed its title: Get Product Catalog cosmetic
- Tool “get_product_quote” changed its title: Get Product Quote cosmetic
- Tool “get_webhook_settings” changed its title: Get Webhook Settings cosmetic
- Tool “get_workspace_settings” changed its title: Get Workspace Settings cosmetic
- Tool “hold_email_postcard_review” changed its title: Hold Email Postcard Review cosmetic
- Tool “list_addresses” changed its title: List Addresses cosmetic
- Tool “list_cover_sheets” changed its title: List Cover Sheets cosmetic
- Tool “list_email_letterheads” changed its title: List Email Letterheads cosmetic
- Tool “list_email_letters” changed its title: List Email Letters cosmetic
- Tool “list_email_postcards” changed its title: List Email Postcards cosmetic
- Tool “list_jobs” changed its title: List Jobs cosmetic
- Tool “prepare_email_letter” changed its title: Prepare Email Letter cosmetic
- Tool “preview_email_letter” changed its title: Preview Email Letter cosmetic
- Tool “preview_email_letterhead” changed its title: Preview Email Letterhead cosmetic
- Tool “preview_email_postcard” changed its title: Preview Email Postcard cosmetic
- Tool “preview_letter” changed its title: Preview Letter cosmetic
- Tool “preview_product_quote” changed its title: Preview Product Quote cosmetic
- Tool “purchase_credits” changed its title: Purchase Credits cosmetic
- Tool “quote_email_postcard” changed its title: Quote Email Postcard cosmetic
- Tool “quote_product” changed its title: Quote Product cosmetic
- Tool “reapply_email_letter” changed its title: Reapply Email Letter cosmetic
- Tool “reject_email_letter” changed its title: Reject Email Letter cosmetic
- Tool “render_cover_sheet” changed its title: Render Cover Sheet cosmetic
- Tool “request_email_box” changed its title: Request Email Box cosmetic
- Tool “revise_email_postcard_quote” changed its title: Revise Email Postcard Quote cosmetic
- Tool “save_address” changed its title: Save Address cosmetic
- Tool “save_cover_sheet” changed its title: Save Cover Sheet cosmetic
- Tool “save_email_letter_rule” changed its title: Save Email Letter Rule cosmetic
- Tool “save_email_letterhead” changed its title: Save Email Letterhead cosmetic
- Tool “save_email_postcard_rule” changed its title: Save Email Postcard Rule cosmetic
- Tool “send_letter” changed its title: Send Letter cosmetic
- Tool “send_product_quote” changed its title: Send Product Quote cosmetic
- Tool “test_webhook” changed its title: Test Webhook cosmetic
- Tool “update_email_letter_polling” changed its title: Update Email Letter Polling cosmetic
- Tool “update_email_letter_settings” changed its title: Update Email Letter Settings cosmetic
- Tool “update_webhook_settings” changed its title: Update Webhook Settings cosmetic
- Tool “update_workspace_settings” changed its title: Update Workspace Settings cosmetic
- Tool “validate_address” changed its title: Validate Address cosmetic
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://directmailamerica.com/api/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=directmailamerica.com | CN=YE2,O=Let's Encrypt,C=US | 23 Sept 2026 | 22 Dec 2026 | ECDSA 256 | ECDSA-SHA384 | 5d9a22b5a63146aff999efadf8a5f557f4f |
| SANs: *.directmailamerica.com, directmailamerica.com | ||||||
| CN=YE2,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 4df3b15dd6c0784c507cd37b58e6f115 |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of directmailamerica.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| directmailamerica.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains |
| content-security-policy | default-src 'self'; script-src 'self' https://www.googletagmanager.com https://www.google-analytics.com https://static.cloudflareinsights.com https://www.gstatic.com https://apis.google.com https://www.google.com/recaptcha/ https://web.squarecdn.com https://sandbox.web.squarecdn.com https://pay.google.com; style-src 'self' 'unsafe-inline' https://web.squarecdn.com https://sandbox.web.squarecdn.com; img-src 'self' data: blob: https:; font-src 'self' data: https://square-fonts-production-f.squarecdn.com https://d1g145x70srn7h.cloudfront.net; connect-src 'self' https://directmailamerica.com https://www.directmailamerica.com https://*.google-analytics.com https://www.googletagmanager.com https://cloudflareinsights.com https://*.googleapis.com https://*.google.com https://*.firebaseio.com https://*.firebaseapp.com https://identitytoolkit.googleapis.com https://securetoken.googleapis.com https://firebaseinstallations.googleapis.com https://pci-connect.squareup.com https://pci-connect.squareupsandbox.com https://con |
| x-content-type-options | nosniff |
| x-frame-options | SAMEORIGIN |
| referrer-policy | strict-origin-when-cross-origin |
| permissions-policy | camera=(), microphone=(self), geolocation=(self) |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://directmailamerica.com/api/mcp | Verified | 200 | |
| http (plaintext) | http://directmailamerica.com/api/mcp | HTTPS enforced | 301 | https://directmailamerica.com/api/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
preview_letter Preview Letter ~230
Render/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 coupon. Postcards default to included full color; letters default to black and white. Composed preview uses the first recipient. For a small postcard, the primary PDF remains the one-page print artwork; proof identifies a separate two-page PDF showing the approximate white print border and address side. Review that proof, but submit only the original artwork or body, never the proof. Recheck the final price before sending. Workspace authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | – |
| certified | boolean | – | – |
| color | boolean | – | – |
| couponCode | string | – | – |
| doubleSided | boolean | – | – |
| electronicReturnReceipt | boolean | – | – |
| filename | string | – | – |
| from | object | yes | – |
| mailClass | string | – | – |
| pdfBase64 | string | – | – |
| recipients | array | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| filename | string | – | – |
| mimeType | string | – | – |
| operation | object | yes | – |
| pages | integer | – | – |
| priceCents | integer | – | – |
| sizeBytes | integer | – | – |
| uri | string | – | – |
No examples provided.
preview_product_quote Preview Product Quote ~78
Download 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 or purchases postage. Workspace authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
| recipient | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| filename | string | – | – |
| mimeType | string | – | – |
| operation | object | yes | – |
| proofNote | string | – | – |
| quote | object | – | – |
| sizeBytes | integer | – | – |
| uri | string | – | – |
No examples provided.
process_email_inbox Process Email Inbox ~156
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 limit, with the same matching, approval, authorized autosend, budget and duplicate safeguards as scheduled checks. Existing consented autosend can purchase postage; this tool grants no new consent. A shared worker lease prevents overlapping checks. Server enforces a 60-second cooldown per workspace, including failed attempts; retryAfterSeconds indicates when to retry. Respects admin and workspace pauses. Returns processed count, morePending, updated workspace and demo state; no mailbox credentials.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| morePending | boolean | – | – |
| operation | object | yes | – |
| processed | integer | – | – |
| retryAfterSeconds | integer | – | – |
| workspace | object | – | – |
No examples provided.
purchase_credits Purchase Credits ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| amountCents | integer | – | USD cents. Minimum 100 ($1.00). |
| paymentSignature | string | – | Base64 x402 PaymentPayload (same value as the HTTP PAYMENT-SIGNATURE header). Retry after a payment_required challenge. |
| Name | Type | Req | Description |
|---|---|---|---|
| amountCents | integer | – | – |
| creditsCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
| error | string | – | – |
| operation | object | yes | – |
| paymentId | string | – | – |
| settlement | object | – | – |
| status | string | – | – |
| success | boolean | – | – |
No examples provided.
quote_email_postcard Quote Email Postcard ~193
Prepare 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 payment and sends no mail. Returns immutable quote id, exact totalCents and expiresAt; retries recover an existing active quote without replacing its content. Use get_email_postcard_quote to review its exact saved proof and addresses, then send_product_quote with confirmed:true only after explicit human approval. Use revise_email_postcard_quote before changing an existing unsent quote; uncertain or paid orders cannot be replaced.
| Name | Type | Req | Description |
|---|---|---|---|
| artworkId | string | – | – |
| attachment | – | yes | – |
| from | object | yes | – |
| id | string | yes | – |
| message | string | yes | – |
| postcardType | string | – | – |
| to | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | – | – | – |
| error | string | – | – |
| expiresAt | string | – | – |
| from | object | – | – |
| id | string | – | – |
| operation | object | yes | – |
| options | object | – | – |
| queue | object | – | – |
| quote | object | – | – |
| quoteId | string | – | – |
| recipients | array | – | – |
| status | string | – | – |
| totalCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
No examples provided.
quote_letter Quote Letter ~372
Create 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 idempotencyKey. Changed content requires a new quote and fresh approval. Full-profile guest quote IDs are private bearer capabilities.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | Plain-text letter body when not uploading a PDF |
| certified | boolean | – | – |
| color | boolean | – | Color letter printing adds $0.49 per printed page per recipient. Express postcards default to included full color: true preserves color; false converts the mailed PDF to grayscale. |
| couponCode | string | – | Server-validated catalog code (case-insensitive). Applied to charged/quoted cents only — staging keys still never buy postage. Unknown codes are rejected. |
| doubleSided | boolean | – | – |
| electronicReturnReceipt | boolean | – | – |
| environment | string | – | Guest-only. staging mints a lbl_test_ key and dry-runs fulfillment (never buys postage). Default production. Payments and credit debits may still be real; staging does not select a payment sandbox. |
| filename | string | – | – |
| from | – | yes | – |
| mailClass | string | – | – |
| pageCount | integer | – | Actual inspected PDF page count determines the send price; this field cannot override it. |
| pdfBase64 | string | – | Print-ready PDF as base64, maximum 25 MiB decoded. Embedded fonts are preserved. Express postcard: exactly one unrotated 5.5 × 4.25 inch (396 × 306 point) page, matching page boxes, no added bleed or… |
| recipients | array | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| filename | string | – | – |
| mimeType | string | – | – |
| operation | object | yes | – |
| quote | object | – | – |
| sizeBytes | integer | – | – |
| uri | string | – | – |
No examples provided.
quote_product Quote Product ~481
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; postcards require one landscape front artwork page. Two-sided postcard: pro_postcard_85x55, doubleSided:true, color:true, plus reverseMessage OR reverseArtworkBase64; the server assembles two pages. Maximum 25 MiB combined artwork. Staging quotes are demo estimates. Temporary pricing failures return a saved queued request with totalCents:null and a next-attempt time. Poll get_product_quote with the same ID; never recreate a queued request. A queue_held result needs review. Obtain approval of artwork, addresses and the final total after status becomes ready before sending.
| Name | Type | Req | Description |
|---|---|---|---|
| color | boolean | – | – |
| doubleSided | boolean | – | Two-sided postcards: productId pro_postcard_85x55, true, color:true, plus exactly one reverse input. Other postcard sizes remain single-sided. |
| electronicReturnReceipt | boolean | – | – |
| filename | string | – | – |
| from | object | yes | – |
| paper | string | – | – |
| pdfBase64 | string | yes | Base64 PDF, maximum 25 MiB decoded. Every page must match the selected product dimensions; postcards require one landscape front artwork page. For pro_postcard_85x55 with doubleSided:true, supply rev… |
| productId | string | yes | – |
| recipients | array | yes | – |
| returnEnvelope | string | – | – |
| reverseArtworkBase64 | string | – | For pro_postcard_85x55 with doubleSided:true only: one unrotated PDF page, fitted into the 282 × 348 point reverse left area. No raw images, added bleed or crop marks. Choose this OR reverseMessage.… |
| reverseMessage | string | – | For pro_postcard_85x55 with doubleSided:true only: plain text on the reverse left side, maximum 21 wrapped lines. Choose this OR reverseArtworkBase64. Unsupported glyphs and overflow are rejected. |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | – | – | – |
| demo | boolean | – | – |
| error | string | – | – |
| expiresAt | string | – | – |
| from | object | – | – |
| id | string | – | – |
| jobId | string | – | – |
| operation | object | yes | – |
| options | object | – | – |
| queue | object | – | – |
| quoteId | string | – | – |
| recipients | array | – | – |
| status | string | – | – |
| totalCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
No examples provided.
reapply_email_letter Reapply Email Letter ~184
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 the pinned version), recalculates price and increments version. Always forces approval mode and strips autosend consent; never buys postage, changes credits or dispatches. Production key required. Refuses submitted, uncertain, rejected, deletion-pending and one-time drafts without a saved rule. Optional ruleFingerprint guards an already-reviewed rule snapshot with its resolved latest letterhead reference; concurrent rule/letterhead/draft changes reject the update. Download and review the regenerated PDF and address before explicitly approving.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
| ruleFingerprint | string | – | – |
| version | integer | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | – |
| error | string | – | – |
| message | – | – | – |
| operation | object | yes | – |
No examples provided.
reconcile_credit_payment Reconcile Credit Payment ~53
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.
| Name | Type | Req | Description |
|---|---|---|---|
| paymentId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| amountCents | integer | – | – |
| creditsCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
| error | string | – | – |
| operation | object | yes | – |
| paymentId | string | – | – |
| settlement | object | – | – |
| status | string | – | – |
| success | boolean | – | – |
No examples provided.
refresh_job_status Refresh Job Status ~55
Contact 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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| job | object | – | – |
| operation | object | yes | – |
No examples provided.
reject_email_letter Reject Email Letter ~42
No charge. Reject an owned pending or blocked letter without mailing it. Production key required. Cannot cancel a submitted or uncertain mailing.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | – |
| error | string | – | – |
| message | – | – | – |
| operation | object | yes | – |
No examples provided.
render_cover_sheet Render Cover Sheet ~73
Render 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.
| Name | Type | Req | Description |
|---|---|---|---|
| design | object | yes | – |
| from | object | yes | – |
| to | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| filename | string | – | – |
| mimeType | string | – | – |
| operation | object | yes | – |
| pages | integer | – | – |
| priceCents | integer | – | – |
| sizeBytes | integer | – | – |
| uri | string | – | – |
No examples provided.
request_email_box Request Email Box ~67
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 letter is sent by this tool.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| morePending | boolean | – | – |
| operation | object | yes | – |
| processed | integer | – | – |
| retryAfterSeconds | integer | – | – |
| workspace | object | – | – |
No examples provided.
revise_email_postcard_quote Revise Email Postcard Quote ~100
Expire 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 the old quote's approval and requires fresh review; no payment or mailing.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| quoteId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| operation | object | yes | – |
| quoteId | string | – | – |
| requiresFreshApproval | boolean | – | – |
| revised | boolean | – | – |
No examples provided.
save_address Save Address ~61
Save 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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | object | yes | – |
| id | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| city | string | – | – |
| error | string | – | – |
| id | string | – | – |
| line1 | string | – | – |
| name | string | – | – |
| operation | object | yes | – |
| postal | string | – | – |
| state | string | – | – |
No examples provided.
save_cover_sheet Save Cover Sheet ~191
Create 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 id and version:0 to create, or the existing id and current version to edit. A stale version fails; reread before saving again. Use defaultDesign to reset a draft. Maximum 25 designs. Validates fit and preserves fixed envelope address windows. No charge or mailing; does not attach the design to mail or change existing PDFs or saved quotes. Requires OAuth read/write and production workspace access, except the isolated reviewer workspace may save synthetic test designs. Workspace authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| design | object | yes | – |
| id | string | yes | – |
| name | string | yes | – |
| version | integer | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| coverSheet | object | – | – |
| error | string | – | – |
| operation | object | yes | – |
No examples provided.
save_email_letter_rule Save Email Letter Rule ~264
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 subject conditions still apply with AND. Matching trims whitespace and ignores capitalization. Existing single-sender and recipient-only rules keep their behavior. Editing the sender list requires renewed autosend consent. subjectContains holds the subject text; subjectMatch is contains (default) or exact, ignoring capitalization. US return/destination addresses, approval or autosend, font, size and page limit. Optional color defaults false; true adds $0.49 for each page and submits color ink. Site previews show grayscale when false. Optional letterhead:{id,version} pins a saved preset. Optional format controls printed fields, greeting, signature, reply cleanup, spacing/margins/page numbers. First enabled match wins; replacement keeps its position. Default approval, Times Roman 12 pt, 10 pages. Production key required. Autosend requires explicit human recurring-mailing authorization and consent=true; never infer consent. Changes apply to future emails.
| Name | Type | Req | Description |
|---|---|---|---|
| consent | boolean | – | – |
| rule | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| morePending | boolean | – | – |
| operation | object | yes | – |
| processed | integer | – | – |
| retryAfterSeconds | integer | – | – |
| workspace | object | – | – |
No examples provided.
save_email_letterhead Save Email Letterhead ~192
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 pdfBase64 (unlocked one-page 8.5x11 unrotated US Letter, max 4 MB). PDF edits may omit pdfBase64 to retain their owned artwork. Layout top/bottom/left/right margins are inches; apply:first or all; ruling:none, solid or dashed; lineColor is hex. Text elements may have empty text; an empty elements array creates blank stationery. Canvas positions/sizes are PDF points from top left inside 18–594 x 18–774. Rules pin {id,version}; editing never updates existing rules or reviewed drafts. No postage or consent.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| letterhead | object | – | – |
| operation | object | yes | – |
No examples provided.
save_email_postcard_rule Save Email Postcard Rule ~394
Save 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: omit recognizable image-request sentences or labeled prompt blocks from email-derived printed text, while retaining the original body for artwork. False retains them; custom messages and explicit preview/quote message edits are unchanged. postcardType selects single_sided (default for new rules) or double_sided; existing rules without the field retain double_sided. The sender field plus optional additionalSenders (up to 19 exact email addresses) form an OR list. Any listed sender can match; recipient and subject conditions still apply with AND. Matching trims whitespace and ignores capitalization. Existing single-sender and recipient-only rules keep their behavior. Editing the sender list requires renewed autosend consent. All conditions must match; first enabled match wins. Choose mode:approval (default) or mode:auto. Saving any rule requires production workspace authentication and OAuth mcp:read/mcp:write/mcp:send. For artwork:generate in either mode, obtain permission to share up to the first 1200 characters of verified matching emails and saved style instructions with the image service during inbox processing. Approval mode prepares artwork before review without mailing. For auto, obtain explicit recurring authorization for prepaid-credit spending within shared sending limits and terms, then pass consent:true; generated artwork also requires authorization to share matching email text and style instructions with the image service. Consent is required again when updating an automatic rule. At most 25 rules. Saving does not itself send mail, but future verified matching emails may generate artwork, spend credits and mail automatically. Unverified signatures, insufficient credits, exceeded lim…
| Name | Type | Req | Description |
|---|---|---|---|
| consent | boolean | – | – |
| rule | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| artwork | object | – | – |
| error | string | – | – |
| message | – | – | – |
| operation | object | yes | – |
| workspace | object | – | – |
No examples provided.
send_letter Send Letter ~568
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 approval. Supports one First-Class letter, Certified Mail piece or Express postcard, including a single self-addressed piece. Can immediately spend credits and buy postage, or settle an explicitly authorized guest x402 payment. A safe preauthorization failure queues the approved order for automatic retry without another debit. Queued is not submitted. Retry the same quote and key; get_letter_quote recovers the saved result. Unknown authorization stays held for review. Staging prevents postage but can spend real money; use the separate simulation endpoint for no-cost tests.
| Name | Type | Req | Description |
|---|---|---|---|
| approvedTotalCents | integer | yes | – |
| body | string | – | Plain-text letter body when not uploading a PDF |
| certified | boolean | – | – |
| color | boolean | – | Color letter printing adds $0.49 per printed page per recipient. Express postcards default to included full color: true preserves color; false converts the mailed PDF to grayscale. |
| confirmed | boolean | yes | – |
| couponCode | string | – | Server-validated catalog code (case-insensitive). Applied to charged/quoted cents only — staging keys still never buy postage. Unknown codes are rejected. |
| doubleSided | boolean | – | – |
| electronicReturnReceipt | boolean | – | – |
| environment | string | – | Guest-only. staging mints a lbl_test_ key and dry-runs fulfillment (never buys postage). Default production. Payments and credit debits may still be real; staging does not select a payment sandbox. |
| filename | string | – | – |
| from | – | – | – |
| idempotencyKey | string | yes | Required for workspace-credit sends. Generate once per intended mailing and reuse for identical retries. Uncertain results remain reserved and cannot automatically resubmit. |
| mailClass | string | – | – |
| pageCount | integer | – | Actual inspected PDF page count determines the send price; this field cannot override it. |
| paymentSignature | string | – | Base64 x402 PaymentPayload (same value as the HTTP PAYMENT-SIGNATURE header). Retry after a payment_required challenge. |
| pdfBase64 | string | – | Print-ready PDF as base64, maximum 25 MiB decoded. Embedded fonts are preserved. Express postcard: exactly one unrotated 5.5 × 4.25 inch (396 × 306 point) page, matching page boxes, no added bleed or… |
| quoteId | string | yes | Immutable quote returned by quote_letter. Review its exact PDF, addresses, options and total before approval. |
| recipients | array | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| balanceCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
| createdAt | string | – | – |
| error | string | – | – |
| id | string | – | – |
| intentId | string | – | – |
| operation | object | yes | – |
| priceCents | integer | – | – |
| quote | object | – | – |
| quoteId | string | – | – |
| replay | boolean | – | – |
| settlement | object | – | – |
| status | string | – | – |
| statusLabel | string | – | – |
| trackingNumber | string|null | – | – |
No examples provided.
send_product_quote Send Product Quote ~107
With Bearer auth and confirmed=true, spend workspace credits and release the immutable saved quote. MCP accepts credits only for this tool; fund the workspace first. Reuse the same quote id after a timeout; retries never send it twice. authorizing / needs_review requires reconciliation, not a replacement order. Staging never mails. Email to Postcard quotes require a production workspace credential and the usual OAuth read/write/send permissions.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | – | – | – |
| demo | boolean | – | – |
| error | string | – | – |
| expiresAt | string | – | – |
| from | object | – | – |
| id | string | – | – |
| jobId | string | – | – |
| operation | object | yes | – |
| options | object | – | – |
| queue | object | – | – |
| quoteId | string | – | – |
| recipients | array | – | – |
| status | string | – | – |
| totalCents | integer|null | – | USD cents. Null means not applicable or not known; never interpret null as zero. |
No examples provided.
test_webhook Test Webhook ~63
After 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 required.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| delivered | boolean | – | – |
| error | string | – | – |
| operation | object | yes | – |
| reason | string | – | – |
| status | integer | – | – |
No examples provided.
update_email_letter_polling Update Email Letter Polling ~100
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 autosend across workspaces. Preserves active scheduler leases; does not invoke the worker immediately.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | yes | – |
| intervalMinutes | integer | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| control | object | – | – |
| error | string | – | – |
| operation | object | yes | – |
No examples provided.
update_email_letter_settings Update Email Letter Settings ~98
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 may resume previously authorized autosend; obtain approval for spending limits. No automatic card charges.
| Name | Type | Req | Description |
|---|---|---|---|
| budget | object | yes | – |
| enabled | boolean | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| morePending | boolean | – | – |
| operation | object | yes | – |
| processed | integer | – | – |
| retryAfterSeconds | integer | – | – |
| workspace | object | – | – |
No examples provided.
update_webhook_settings Update Webhook Settings ~111
Set 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 destination creates a strong signing secret if none is usable. Retrieve the secret in the authenticated website Developers screen to configure the receiver; MCP never returns it. Does not send a test. Workspace authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| url | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| deliveries | array | – | – |
| error | string | – | – |
| operation | object | yes | – |
| signingConfigured | boolean | – | – |
| url | string|null | – | – |
No examples provided.
update_workspace_settings Update Workspace Settings ~78
Update 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.
| Name | Type | Req | Description |
|---|---|---|---|
| fromAddressId | – | – | – |
| name | string | – | – |
| orgName | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| fromAddressId | string|null | – | – |
| name | string | – | – |
| operation | object | yes | – |
| orgName | string | – | – |
No examples provided.
validate_address Validate Address ~44
Check and normalize U.S. postal address formatting. This is not postal deliverability or address verification. No persistence or mailing. Workspace authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| address | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | string | – | – |
| issues | array | – | – |
| normalized | object | – | – |
| note | string | – | – |
| operation | object | yes | – |
| valid | boolean | – | – |
No examples provided.
How do I install the DirectMailAmerica — Full MCP server?
DirectMailAmerica — Full is a hosted endpoint at https://directmailamerica.com/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · directmailamerica.com
claude mcp add --transport http com-directmailamerica-mcp 'https://directmailamerica.com/api/mcp'
What is the DirectMailAmerica — Full MCP server?
DirectMailAmerica — Full is an MCP server listed in the public MCP registry as com.directmailamerica/mcp. Mail approved U.S. letters, Certified Mail and postcards; cover sheets and email-to-mail automation. This page covers its hosted endpoint (https://directmailamerica.com/api/mcp).
Is the DirectMailAmerica — Full MCP server safe to use?
DirectMailAmerica — Full scores 69 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the DirectMailAmerica — Full MCP server expose?
DirectMailAmerica — Full exposes 75 tools: get_connection_status, get_product_catalog, quote_product, send_product_quote, send_letter, and 70 more. Their descriptions and schemas cost roughly 9,069 tokens of context every time the server is loaded.
Does the DirectMailAmerica — Full MCP server require authentication?
No. We connected to DirectMailAmerica — Full without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the DirectMailAmerica — Full MCP server still maintained?
DirectMailAmerica — Full is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.