Card Mailer
Print and mail 5x7 holiday and thank-you photo cards to a US address list. $2.49/card incl. postage.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"card-mailer": {
"url": "https://cards.onmax.me/mcp"
}
}
}Remote-Endpunkte
https://cards.onmax.me/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (6)
🟢import_address_list(addresses_text, address_file, list_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"addresses_text": {
"description": "Addresses as pasted text or CSV. One recipient per line (\"Name, Street, City, ST ZIP\") or a CSV with a header row.",
"type": "string",
"maxLength": 200000
},
"address_file": {
"description": "A CSV or XLSX file the user attached.",
"type": "object",
"properties": {
"download_url": {
"type": "string"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
]
},
"list_id": {
"description": "Existing list to append to.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "list"
},
"list_id": {
"type": "string"
},
"total": {
"type": "number"
},
"ready": {
"type": "number"
},
"corrected_by_usps": {
"type": "number"
},
"needs_fixing": {
"type": "number"
},
"problems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"given": {
"type": "string"
},
"problem": {
"type": "string"
}
},
"required": [
"row",
"given",
"problem"
],
"additionalProperties": false
}
},
"usps_checked": {
"type": "boolean"
},
"skipped_over_limit": {
"type": "number"
}
},
"required": [
"kind",
"list_id",
"total",
"ready",
"corrected_by_usps",
"needs_fixing",
"problems"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴fix_address(list_id, row, remove, name, line1, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"row": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"remove": {
"description": "Remove this recipient from the mailing.",
"type": "boolean"
},
"name": {
"type": "string",
"maxLength": 40
},
"line1": {
"description": "Street address",
"type": "string",
"maxLength": 64
},
"line2": {
"description": "Apartment, suite, unit",
"type": "string",
"maxLength": 64
},
"city": {
"type": "string",
"maxLength": 40
},
"state": {
"type": "string",
"maxLength": 20
},
"zip": {
"type": "string",
"maxLength": 10
}
},
"required": [
"list_id",
"row"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "list"
},
"list_id": {
"type": "string"
},
"total": {
"type": "number"
},
"ready": {
"type": "number"
},
"corrected_by_usps": {
"type": "number"
},
"needs_fixing": {
"type": "number"
},
"problems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"given": {
"type": "string"
},
"problem": {
"type": "string"
}
},
"required": [
"row",
"given",
"problem"
],
"additionalProperties": false
}
},
"usps_checked": {
"type": "boolean"
},
"skipped_over_limit": {
"type": "number"
}
},
"required": [
"kind",
"list_id",
"total",
"ready",
"corrected_by_usps",
"needs_fixing",
"problems"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴design_card(design_id, photo, photo_url, remove_photo, style, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"design_id": {
"type": "string"
},
"photo": {
"description": "Photo the user attached for the front.",
"type": "object",
"properties": {
"download_url": {
"type": "string"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
]
},
"photo_url": {
"description": "Public https URL of the front photo.",
"type": "string",
"format": "uri"
},
"remove_photo": {
"type": "boolean"
},
"style": {
"description": "classic (red), evergreen (green), winter (blue), minimal (white), thanks (warm, for thank-you cards).",
"type": "string",
"enum": [
"classic",
"evergreen",
"winter",
"minimal",
"thanks"
]
},
"greeting": {
"description": "Front headline, e.g. \"Happy Holidays\", \"Merry Christmas\", \"Thank You\".",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"message": {
"description": "Message printed on the back.",
"type": "string",
"maxLength": 500
},
"sign_off": {
"description": "Signature on the back, e.g. \"Love, The Garcias\".",
"type": "string",
"maxLength": 80
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "design"
},
"design_id": {
"type": "string"
},
"style": {
"type": "string"
},
"greeting": {
"type": "string"
},
"message": {
"type": "string"
},
"sign_off": {
"type": "string"
},
"has_photo": {
"type": "boolean"
},
"photo_warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"design_id",
"style",
"greeting",
"message",
"sign_off",
"has_photo",
"photo_warning"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢quote_mailing(list_id, arrive_by, send_date)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"arrive_by": {
"description": "Date the cards should arrive by, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"send_date": {
"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).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "quote"
},
"quantity": {
"type": "number"
},
"unit_price": {
"type": "string"
},
"total": {
"type": "string"
},
"total_cents": {
"type": "number"
},
"send_date": {
"type": "string"
},
"arrives_between": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"latest_send_date": {
"type": "string"
},
"on_time": {
"type": "boolean"
},
"needs_fixing": {
"type": "number"
}
},
"required": [
"kind",
"quantity",
"unit_price",
"total",
"total_cents",
"send_date",
"arrives_between",
"notes",
"needs_fixing"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡create_mailing(list_id, design_id, send_date, arrive_by, sender)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"design_id": {
"type": "string"
},
"send_date": {
"description": "Date to print and mail, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"arrive_by": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sender": {
"description": "Return address (US).",
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 40
},
"line1": {
"type": "string",
"maxLength": 64
},
"line2": {
"type": "string",
"maxLength": 64
},
"city": {
"type": "string",
"maxLength": 40
},
"state": {
"type": "string",
"maxLength": 20
},
"zip": {
"type": "string",
"maxLength": 10
}
},
"required": [
"name",
"line1",
"city",
"state",
"zip"
]
}
},
"required": [
"list_id",
"design_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "mailing"
},
"mailing_id": {
"type": "string"
},
"list_id": {
"type": "string"
},
"design_id": {
"type": "string"
},
"checkout_url": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit_price": {
"type": "string"
},
"total": {
"type": "string"
},
"total_cents": {
"type": "number"
},
"send_date": {
"type": "string"
},
"arrives_between": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"latest_send_date": {
"type": "string"
},
"on_time": {
"type": "boolean"
},
"needs_fixing": {
"type": "number"
}
},
"required": [
"kind",
"mailing_id",
"list_id",
"design_id",
"checkout_url",
"quantity",
"unit_price",
"total",
"total_cents",
"send_date",
"arrives_between",
"notes",
"needs_fixing"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_mailing_status(mailing_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"mailing_id": {
"type": "string"
}
},
"required": [
"mailing_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "status"
},
"mailing_id": {
"type": "string"
},
"status": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total": {
"type": "string"
},
"send_date": {
"type": "string"
},
"arrives_between": {
"type": "array",
"items": {
"type": "string"
}
},
"counts": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"checkout_url": {
"type": "string"
},
"addresses_deleted": {
"type": "boolean"
}
},
"required": [
"kind",
"mailing_id",
"status",
"quantity",
"total",
"send_date",
"arrives_between",
"counts",
"checkout_url",
"addresses_deleted"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Nachweis