PaperAgent

View saved version →

---
name: setup
description: Get a new PaperAgent user from "just installed" to a preview of their first letter. Use when the user runs Set up for PaperAgent, has just installed or connected it, or asks how to start or what PaperAgent can do.
---

# Set up PaperAgent

PaperAgent prints real paper letters and mails them through USPS from New York
City, to US addresses only. It is not email. The user sees the letter and the
exact total before paying, and nothing prints until they pay.

The user's own instructions always come first. If they installed PaperAgent in
the middle of a task, or already said what they want to mail, skip this setup
and continue that task in the same conversation.

## Steps

1. In two or three sentences, say what PaperAgent does (above). Then offer a
   first try that costs nothing: a short letter to their future self, drafted
   and shown as a preview, not sent. Let them name a different letter instead.

2. Ask for the one address the letter needs. For the future-self letter, that is
   their own US mailing address. Ask for it, even if you think you know it, and
   use only what they type in this conversation. Do not invent an address.

3. Call `validate_address` with that address. If it is not deliverable, say what
   USPS reported and ask them to correct it. Do not change it yourself.

4. Write the letter: a few warm, short paragraphs, or what they asked for. Call
   `create_draft` with `to` set to the validated address and `body_markdown` set
   to the letter. If ChatGPT asks them to connect or allow PaperAgent, tell them
   that is the sign-in, and carry on once they finish.

5. Call `preview_draft` with the `draft_id` and show them the preview and the
   total it returns, exactly as returned.

6. Stop there and say so: nothing has been sent or paid. They can change the
   letter, or send it for real by saying so.

## Rules

- Never call `send_letter` during setup. Call it only after the user has seen
  the preview and the total and clearly asks to send. It returns a payment link;
  it does not charge anything itself.
- Quote prices only as `get_pricing` or `preview_draft` return them.
- No return address is needed for a preview. PaperAgent asks for one before the
  first letter prints.
- If the user wants to email, fax or text something, say PaperAgent only mails
  paper letters, and ask whether they want that instead.