token-of-esteem
A press your agent can commission: a funny, personalized printed booklet, mailed as a gift.
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeRead-only
What it can do
What data it sees
Do you need an account
An API key from the service settings is required
A press your agent can commission: a funny, personalized printed booklet, mailed as a gift.
Server tool list (12)
Raw names from tools/list. Only developers need these.
| list_voices | List the three comedic voices (Hype Man, Best Friend Roast, Conspiracy Theorist) and the cover image model each prefers. Free, no side effects. Call this first to pick a voice. |
| list_formats | List supported booklet formats. There is one today: manual_v1, a 16-page booklet. Free, no side effects. |
| list_image_models | List supported cover image models and their per-call cost. Free, no side effects. |
| get_pricing | Compute the exact total for a hypothetical gift (format, voice, image model, ship_to) before you commit. Free, no order is created. Call before create_gift so you know the charge. |
| validate_brief | Run the content policy on a brief without charging or ordering. Free. Call before create_gift so a refusal surfaces early. A booklet that would wound the recipient is refused here, not at charge time. |
| create_gift | Place the order: write, print, and mail the booklet. CHARGES the buyer. The recipient is whoever you name in recipient, which may be your own user. Idempotent on idempotency_key for 24 hours. Pass shared_payment_token to pay tokenlessly, or omit it to charge the account's saved card. |
| get_gift | Fetch a gift by gift_id and return its full resource: status, voice, format, pricing, the recipient, and fulfillment (Lulu job id, carrier, tracking URL, estimated delivery). Free and read-only. Use it to poll progress after create_gift: status advances through the pipeline to shipped then delivered, or ends at held, refused, cancelled, or failed. |
| list_gifts | Paginated list of gifts on the account, with optional status and date filters. Free. |
| cancel_gift | Cancel an in-flight gift and receive the refund amount. Free. Only possible before the booklet goes to print; once printing has started it fails with cancel_too_late. Pass the gift_id from create_gift and an optional reason for your records. |
| get_account | Return this account's spending caps and month-to-date spend. Free. Use it to confirm budget before create_gift. |
| list_recipients | Return the account's saved recipients (address book). Free. Reuse a recipient_id in create_gift instead of re-entering an address. |
| create_setup_link | Return a hosted Stripe link for the buyer to save a card or wallet to the account. After that, create_gift without a shared_payment_token charges the saved card. |