Premier Letters

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• get_pricing

  Get a live price quote for a Premier Letters order. Pass char_count (or letter_count for a rough estimate) plus optional mailing_option and paper_type to get a per-piece and total price, in cents. No

• list_handwriting_styles

  List available handwriting styles (fonts) for a letter order. Use the returned "id" as options.handwriting_style / handwriting_style when creating an order or previewing.

• list_templates

  List the authenticated user's saved letter templates.

• verify_address

  Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.

• preview_letter

  Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.

• create_order

  Create and pay for a Premier Letters order — a real, handwritten letter mailed via USPS. Requires a Premier Letters API key. Use get_pricing or preview_letter first to confirm the price. For payment,

• get_order_status

  Get an order's status, delivery/tracking summary, and per-recipient mail status.

• list_orders

  List the authenticated user's recent orders.