com.tokenofesteem/token-of-esteem

Official12 tools

A press your agent can commission: a funny, personalized printed booklet, mailed as a gift.

Commission personalized printed booklets as gifts with custom designs.

Captured live from the server via tools/list.

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.

No parameters.

list_formats

List supported booklet formats. There is one today: manual_v1, a 16-page booklet. Free, no side effects.

No parameters.

list_image_models

List supported cover image models and their per-call cost. Free, no side effects.

No parameters.

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.

Parameters (4)

formatstring
Booklet format to price. Only manual_v1 is supported today.
ship_toobjectrequired
Destination address. US is supported; the total and tax depend on the destination.
voicestring
Optional comedic voice. It does not change the price; accepted for parity with create_gift.
image_modelstring
Optional cover image model id. Some models add a small per-call cost.

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.

Parameters (1)

briefobjectrequired
The same brief you would pass to create_gift. It is checked against the content policy, free, with no order created.

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.

Parameters (7)

idempotency_keystringrequired
Caller-chosen key that makes this order idempotent for 24 hours. Reuse the same key to retry safely without charging twice.
formatstring
Booklet format. Only manual_v1, a 16-page booklet, is supported today.
briefobjectrequired
Structured brief about the recipient: what to celebrate, what to tease gently, and the inside jokes worth knowing.
recipientanyrequired
Who receives the booklet and where to mail it. Pass an inline recipient with a US ship_to, or a saved recipient_id.
preview_before_printboolean
If true, the gift pauses for buyer review before printing instead of printing automatically.
agent_notestring
Optional note from the agent, stored with the order for support. Never printed in the booklet.
shared_payment_tokenstring
Single-use Stripe Shared Payment Token (spt_...) to pay without a stored card. Omit to charge the account default.

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.

Parameters (1)

gift_idstringrequired
The gift_id returned by create_gift, identifying the order to fetch.

list_gifts

Paginated list of gifts on the account, with optional status and date filters. Free.

Parameters (4)

statusstring
Only return gifts in this status, for example shipped, delivered, or cancelled.
sincestring
Only return gifts created at or after this ISO 8601 timestamp.
limitinteger
Maximum number of gifts to return, 1 to 100. Defaults to 50.
cursorstring
Opaque pagination cursor from a previous list_gifts response.

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.

Parameters (2)

gift_idstringrequired
The gift_id returned by create_gift, identifying the order to cancel.
reasonstring
Optional human-readable reason for the cancellation, recorded on the order.

get_account

Return this account's spending caps and month-to-date spend. Free. Use it to confirm budget before create_gift.

No parameters.

list_recipients

Return the account's saved recipients (address book). Free. Reuse a recipient_id in create_gift instead of re-entering an address.

No parameters.

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.

Parameters (1)

return_urlstring

Install

claude_desktop_config.json

{
  "mcpServers": {
    "token-of-esteem": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tokenofesteem.com/v1/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.