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
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.
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.
Give the status in plain words: for example, received by the printer, printed, or handed to 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.tracking.tracking_number (the USPS Certified Mail number) and tracking.usps_tracking_url, where they can see every scan.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.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.
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.
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.