Card Mailer
Print and mail 5x7 holiday and thank-you photo cards to a US address list. $2.49/card incl. postage.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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
}コミュニティ
エビデンス