🔧 Track Mail

Check the status of a letter sent with MailSnail, or cancel one that hasn’t been printed yet. Use when the user asks whether their mail was printed, mailed, or delivered, asks for certified-mail track

Track Mail instructions

Track mail sent with MailSnail

Before you start

This skill uses the MailSnail connector's tools, such as get_letter, cancel_letter and get_balance. If they aren't available in this conversation, the user needs to add MailSnail first. Give them the connector URL, https://api.mailsnail.dev/mcp, and the setup page, https://mailsnail.dev/setup?utm_source=skill, which has the steps for Claude, ChatGPT, Cursor and other apps. Adding it is free; they pay only for the letters they send.

Look up a piece

Status lookups are free. Call get_letter with the letter's receipt_token.

Each send's result includes a receipt_token. Use that, not the id field: id is the printer's job number and won't resolve.

If the user doesn't have the receipt_token, look for it earlier in this conversation. No tool lists past mail. If it isn't here, the user can email hello@mailsnail.dev with the recipient's name and the date sent.

Explain the result

Give the status in plain words: for example, received by the printer, printed, or handed to USPS.

  • Once the letter is with USPS, tracking shows its latest scan (status, status_time, status_location). Before that, tracking.available is false; that's normal for the first 1-2 business days. Tracking updates once a day.
  • For a certified letter, give the user tracking.tracking_number (the USPS Certified Mail number) and tracking.usps_tracking_url, where they can see every scan.
  • With an electronic return receipt, return_receipt.url is the recipient's signature PDF. It works only after delivery, sometimes a few days later. With a green-card receipt, the signed card is mailed back to the sender's address and isn't online.
  • Don't promise a delivery date. USPS First-Class Mail usually takes a few business days, but MailSnail can't guarantee it.

Cancel a letter

If the user wants to stop a letter, call cancel_letter with its receipt_token. Confirm with them first: a cancelled letter is not mailed. It works only before the printer starts, usually about a day after sending, and only for letters sent from the account that is signed in. The letter's price goes back to the user's MailSnail balance, where it pays for their next letter; it isn't returned to the card. If the result is too_late_to_cancel, the letter is already being printed and will be mailed.

Balance

For "how much do I have left?", call get_balance. It's free, and it shows the balance, whether a card is saved, and the auto-reload settings.

To add funds, call add_payment_method and give the user the Stripe link it returns. By default it's a one-time payment of $25, and the card isn't saved.

To stop automatic reloads, call turn_off_auto_reload.

Related Skills

Get the best new skills
in your inbox

Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.