com.tokenofesteem/token-of-esteem

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "token-of-esteem": {
      "url": "https://mcp.tokenofesteem.com/v1/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• 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.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_formats

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_image_models

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • ship_to (required) — object — Destination address. US is supported; the total and tax depend on the destination.
  • voice — string — Optional comedic voice. It does not change the price; accepted for parity with create_gift.
  • format — string — Booklet format to price. Only manual_v1 is supported today.
  • image_model — string — Optional cover image model id. Some models add a small per-call cost.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brief (required) — object — The same brief you would pass to create_gift. It is checked against the content policy, free, with no order created.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • gift_id (required) — string — The gift_id returned by create_gift, identifying the order to fetch.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_gifts

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

  Parameters:

  • limit — integer — Maximum number of gifts to return, 1 to 100. Defaults to 50.
  • since — string — Only return gifts created at or after this ISO 8601 timestamp.
  • cursor — string — Opaque pagination cursor from a previous list_gifts response.
  • status — string — Only return gifts in this status, for example shipped, delivered, or cancelled.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • gift_id (required) — string — The gift_id returned by create_gift, identifying the order to cancel.
  • reason — string — Optional human-readable reason for the cancellation, recorded on the order.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_account

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_recipients

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • return_url — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.