Card Mailer

Working · 772 ms

me.onmax/card-mailerv1.0.1 Domain verified

Print and mail 5x7 holiday and thank-you photo cards to a US address list. $2.49/card incl. postage.

Commerce Design & Creative

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://cards.onmax.me/mcp/claude

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

create_mailing

Use this when the user has seen the card and the quote and says they want to order. Creates an unpaid order for the ready recipients in list_id with design_id and returns a link to cards.onmax.me, where the user reviews the recipients and pays. Nothing is printed, mailed or charged until the user pays on that page. Recipients that still need fixing are left out. Each call creates a separate order link, so call it once per order. Optional sender is printed as the US return address.

list_idstring, required

design_idstring, required

senderobject

Return address (US).

arrive_bystring

send_datestring

Date to print and mail, YYYY-MM-DD.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

create_mailing

Argument	Type	Description
sender	object	Return address (US).
list_id*	string
arrive_by	string
design_id*	string
send_date	string	Date to print and mail, YYYY-MM-DD.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "design_id"
  ],
  "properties": {
    "sender": {
      "type": "object",
      "required": [
        "name",
        "line1",
        "city",
        "state",
        "zip"
      ],
      "properties": {
        "zip": {
          "type": "string",
          "maxLength": 10
        },
        "city": {
          "type": "string",
          "maxLength": 40
        },
        "name": {
          "type": "string",
          "maxLength": 40
        },
        "line1": {
          "type": "string",
          "maxLength": 64
        },
        "line2": {
          "type": "string",
          "maxLength": 64
        },
        "state": {
          "type": "string",
          "maxLength": 20
        }
      },
      "description": "Return address (US)."
    },
    "list_id": {
      "type": "string"
    },
    "arrive_by": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "design_id": {
      "type": "string"
    },
    "send_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date to print and mail, YYYY-MM-DD."
    }
  }
}

design_card

Use this to create or edit the printed 5x7 postcard: a greeting on the front over or under the photo, and a message and sign-off on the back. Pass the photo the user attached as photo, or a public https image URL as photo_url; the image is downloaded and stored on cards.onmax.me. Without a photo the front is the greeting on a solid color. Pass design_id to edit a design: given fields replace the old values and omitted fields keep them. Use the message the user wrote or approved, up to 500 characters. Places the user's photo and text in a print template; does not generate images.

destructive

Argument	Type	Description
photo	object	Photo the user attached for the front.
style	string	classic (red), evergreen (green), winter (blue), minimal (white), thanks (warm, for thank-you cards).
message	string	Message printed on the back.
greeting	string	Front headline, e.g. "Happy Holidays", "Merry Christmas", "Thank You".
sign_off	string	Signature on the back, e.g. "Love, The Garcias".
design_id	string
photo_url	string	Public https URL of the front photo.

fix_address

Use this to correct or remove one recipient in a list from import_address_list, by row number. Given fields replace the stored values and omitted fields keep theirs; if the row's problem says it could not be read, pass name, line1, city, state and zip together. Re-checks the address with USPS data. remove: true takes the recipient out of the mailing. Rows in a list that belongs to a paid order cannot be changed.

destructive

Argument	Type	Description
row*	integer
zip	string
city	string
name	string
line1	string	Street address
line2	string	Apartment, suite, unit
state	string
remove	boolean	Remove this recipient from the mailing.
list_id*	string

Input schema (JSON)

get_mailing_status

Use this when the user asks whether a Card Mailer order was paid, printed, mailed or delivered. Takes the mailing_id returned by create_mailing (also the last part of the order link). Returns the status, send date, expected arrival and per-recipient counts. Does not change the order or track other USPS mail.

read-only

Argument	Type	Description
mailing_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_id"
  ],
  "properties": {
    "mailing_id": {
      "type": "string"
    }
  }
}

import_address_list

Use this when the user wants to mail printed cards to people at US postal addresses and gives the addresses as pasted text, a CSV, or an .xlsx spreadsheet. Reads names and addresses, checks each against USPS data, and saves them as a recipient list. Returns a list_id, how many rows are ready, and the problem for each row that needs fixing. Up to 300 recipients; pass list_id to append rows to an existing list. US addresses only. Not for e-cards or email, addresses outside the US, or advertising mail to purchased or rented lists.

Argument	Type	Description
list_id	string	Existing list to append to.
address_file	object	A CSV or XLSX file the user attached.
addresses_text	string	Addresses as pasted text or CSV. One recipient per line ("Name, Street, City, ST ZIP") or a CSV with a header row.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "Existing list to append to."
    },
    "address_file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "A CSV or XLSX file the user attached."
    },
    "addresses_text": {
      "type": "string",
      "maxLength": 200000,
      "description": "Addresses as pasted text or CSV. One recipient per line (\"Name, Street, City, ST ZIP\") or a CSV with a header row."
    }
  }
}

quote_mailing

Use this when the user asks what mailing a card to an imported list costs or when it will arrive. Returns the price per card (First-Class postage included), the total for the ready recipients, the send date and the expected arrival window. If the cards must arrive by a date, pass arrive_by; the result gives the latest safe send date and whether that date can be met. Does not create an order or charge anything.

read-only

Argument	Type	Description
list_id*	string
arrive_by	string	Date the cards should arrive by, YYYY-MM-DD.
send_date	string	Date to print and mail, YYYY-MM-DD. Default: the latest safe date for arrive_by, otherwise the earliest business day (today if it is one).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string"
    },
    "arrive_by": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date the cards should arrive by, YYYY-MM-DD."
    },
    "send_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date to print and mail, YYYY-MM-DD. Default: the latest safe date for arrive_by, otherwise the earliest business day (today if it is one)."
    }
  }
}