Card Mailer
Print and mail 5x7 holiday and thank-you photo cards to a US address list. $2.49/card incl. postage.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"card-mailer": {
"url": "https://cards.onmax.me/mcp"
}
}
}远程端点
https://cards.onmax.me/mcpstreamable-http它能做什么
工具清单
工具（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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"mailing_id": {
"type": "string"
}
},
"required": [
"mailing_id"
],
"$schema": "https://json-schema.org/draft/2020-12/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
}社区
证据