# DirectMailAmerica

> DirectMailAmerica is a physical letter mailing API and SaaS. Live LetterStream fulfillment: upload a PDF or compose a letter; we print and mail USPS First-Class letters, Certified Mail, and 4×6 postcards. Pay with card or USDC via x402.

DirectMailAmerica.com is operated by Rainmaker LLC d/b/a DirectMailAmerica.com. Office: 7 Elm St 2R, New Haven, CT 06510. Support: support@directmailamerica.com. Hello: hello@directmailamerica.com.

## Product

- Web app for composing or uploading PDFs and sending physical mail
- REST API (`lbl_live_` production keys / `lbl_test_` developer-sandbox keys)
- MCP server for Claude Desktop, Cursor, and other MCP clients
- x402 payments in USDC on Base and Solana (live stables; advertised in every PAYMENT-REQUIRED `accepts[]`)
- MCP guest checkout: `send_letter` without an API key, pay per send with x402, ephemeral org-on-pay
- MCP card top-up via Square hosted checkout (`create_credit_checkout` — no PAN)
- Fulfillment via LetterStream into USPS. Physical mailing is live on this deployment (verified 2026-09-09).
- Staging keys (`lbl_test_`) never purchase postage. Local checkouts without LetterStream credentials stay in labeled demo mode and do not enter the USPS stream.

## Pricing

Authoritative list prices in USD. Credits are 1:1 with USD cents. No subscription required.

- First-Class letter: $1.49 first page + $0.25 each additional page
- Certified Mail: $12.99 base piece (first page included) + $0.25 each additional page
- Postcard: $1.99 flat (4×6 color)
- Optional Certified Electronic Return Receipt: $2.40
- Optional `couponCode` on MCP `send_letter` / `get_pricing` and REST mailing/pricing: server-validated catalog (case-insensitive). `COUPONFORRIGEL` = 99% off the charged/quoted cents. Staging keys still never buy postage.

## Docs

- [Documentation](https://directmailamerica.com/docs): https://directmailamerica.com/docs
- [REST API](https://directmailamerica.com/docs/api): https://directmailamerica.com/docs/api
- [OpenAPI 3.1](https://directmailamerica.com/api/v1/openapi.json): https://directmailamerica.com/api/v1/openapi.json
- [MCP](https://directmailamerica.com/docs/mcp): https://directmailamerica.com/docs/mcp
- [x402 + USDC](https://directmailamerica.com/docs/x402): https://directmailamerica.com/docs/x402
- [Fonts](https://directmailamerica.com/docs/fonts): https://directmailamerica.com/docs/fonts
- [Pricing](https://directmailamerica.com/pricing): https://directmailamerica.com/pricing
- [Guides](https://directmailamerica.com/guides): https://directmailamerica.com/guides
- [Send a letter](https://directmailamerica.com/guides/send-a-letter): https://directmailamerica.com/guides/send-a-letter
- [Public status](https://directmailamerica.com/status): https://directmailamerica.com/status
- [Status JSON](https://directmailamerica.com/status.json): https://directmailamerica.com/status.json

## Optional

- [Full agent brief](https://directmailamerica.com/llms-full.txt): https://directmailamerica.com/llms-full.txt
- [AI plugin descriptor](https://directmailamerica.com/.well-known/ai-plugin.json): https://directmailamerica.com/.well-known/ai-plugin.json
- [MCP discovery](https://directmailamerica.com/.well-known/mcp.json): https://directmailamerica.com/.well-known/mcp.json
- [Contact](https://directmailamerica.com/contact): https://directmailamerica.com/contact
- [Terms of Use](https://directmailamerica.com/terms): https://directmailamerica.com/terms
- [Privacy Policy](https://directmailamerica.com/privacy): https://directmailamerica.com/privacy

## Legal identity

- Legal entity: Rainmaker LLC d/b/a DirectMailAmerica.com
- Legal name: Rainmaker LLC
- DBA: DirectMailAmerica.com
- Office: 7 Elm St 2R, New Haven, CT 06510
- Support: support@directmailamerica.com
- Privacy / legal: hello@directmailamerica.com

## REST API

Base path: https://directmailamerica.com/api/v1

Authenticate with `Authorization: Bearer lbl_live_...` or `lbl_test_...`. Staging keys never purchase postage. Machine-readable spec: https://directmailamerica.com/api/v1/openapi.json

Endpoints:

- `POST /letters` — create a mailing (JSON or multipart PDF)
- `GET /letters` — list mailings
- `GET /letters/:id` — job status
- `POST /addresses/validate` — format-only address stub (not USPS CASS)
- `GET /pricing` — quote (requires API key)
- `POST /credits` — x402 credit purchase (requires API key)

Protected paid resources may return HTTP 402 with an x402 `PAYMENT-REQUIRED` header. Retry with `PAYMENT-SIGNATURE`. Settlement requires `X402_FACILITATOR_URL` (Coinbase CDP) and CDP JWT credentials; missing facilitator or keys fail closed and never mark the payment paid.

## MCP

Hosted HTTP transport: JSON-RPC POST to https://directmailamerica.com/api/mcp. See https://directmailamerica.com/docs/mcp.

Payment rails (not credits-only):

1. **Guest x402** — no prior account or `lbl_` key. Call `send_letter`; HTTP 402 + `PAYMENT-REQUIRED` (also in the tool result). Sign USDC on Base or Solana; retry the same tool with `paymentSignature` or header `PAYMENT-SIGNATURE`. Settle creates an ephemeral org and returns `guestApiKey` once. Optional `couponCode` (e.g. `COUPONFORRIGEL`, 99% off) changes the quoted/charged cents; omit it for full list.
2. **Account / Bearer** — `start_account_login` for the web sign-in URL, then mint a key in Developers. Use org credits and/or pay-per-send x402.
3. **Credits** — prepaid balance via `send_letter` (existing) or `purchase_credits` (x402 top-up).
4. **Cards** — `create_credit_checkout` returns a Square Payment Link. Never send PAN/CVV to MCP. Then `get_payment_status`.
5. **Live stables** — USDC on Base (`eip155:8453`) and USDC on Solana. Same `accepts[]` as REST `POST /api/v1/letters`.

Staging keys (`lbl_test_`) never purchase postage. Guest `environment=staging` mints a test key and dry-runs fulfillment.

Tools:

- `send_letter` — Queue a letter or postcard. Guest x402 (no API key): first call returns payment_required; retry with paymentSignature. Or spend Bearer org credits / pay-per-send x402. Optional couponCode (COUPONFORRIGEL = 99% off charged cents). Staging keys never mail.
- `get_letter_status` — Get status and tracking for a mailing job by id. Requires Bearer key.
- `list_jobs` — List recent mailing jobs for the authenticated workspace.
- `get_pricing` — Quote pricing. No API key required. Optional couponCode. Includes live x402 stables.
- `get_credits` — Prepaid org credit balance. Requires Bearer key.
- `purchase_credits` — Buy credits with x402 USDC (PAYMENT-SIGNATURE). Requires Bearer key.
- `create_credit_checkout` — Square hosted card checkout to fund credits. Never send PAN. Optional guest org + key.
- `get_payment_status` — Complete a Square checkout and add credits. Requires Bearer key.
- `start_account_login` — Web login URL to bind an existing org and mint a lbl_ API key.

Local-dev stdio helper: `scripts/mcp-server.mjs` with `DIRECTMAILAMERICA_API_URL` and `DIRECTMAILAMERICA_API_KEY` (key values still start with `lbl_`). See the local-dev section on https://directmailamerica.com/docs/mcp.

## What this is not

- Not a fax service
- Not email
- No invented ratings, reviews, or award claims
- Staging keys and local demo mode (no LetterStream credentials) do not enter the USPS stream