> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoppier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gift cards server tools

> Search gift-card brands, send gift cards with a Stripe Checkout link, and check a send's status from Claude or ChatGPT.

The Gift cards server (`https://app.hoppier.com/api/mcp/v1`) is for people who send gift cards at [hoppier.com/gift-cards](https://www.hoppier.com/gift-cards). It has three tools.

* **`search_merchants`** searches gift-card brands, optionally in one country. Each brand comes with the amounts it accepts.
* **`send_gift_card`** prepares a gift-card send and returns a Stripe Checkout link to pay for it.
* **`get_gift_card_status`** checks a send: pending payment, payment expired, scheduled, sent, failed or expired.

## send\_gift\_card

Nothing is charged when the assistant calls this tool. It returns a **payment link**, and the gift cards go out only after you pay on that page.

* **Recipients:** 1 to 25 email addresses per send.
* **Amount:** \$5 to \$500 per recipient, in US dollars. The assistant sends it in cents: `2500` is \$25.00.
* **Brands:** limit recipients to up to 20 brands, or leave it open to the whole catalogue.
* **From:** your name, as recipients will see it. Optional subject and message (up to 1,000 characters, plain text).
* **When:** now, or at a future date and time, rounded up to the next hour.
* **Language:** the language of the recipients' email, English by default.
* **Fee:** a 5% activation fee is added to the total. You see the full amount on the payment page before you pay.
* **Retries:** every send carries an `idempotency_key`. Calling again with the same key returns the same send; once the payment link expires after 24 hours, it returns a fresh one.

After you pay, recipients get their gift card by email, at the time you chose.

## Limits

Each account can send up to \$2,500 per send, \$2,500 per rolling day and \$10,000 per rolling week, fee included. If they get in your way, email [support@hoppier.com](mailto:support@hoppier.com).

## Status

`get_gift_card_status` takes the `send_id` that `send_gift_card` returned:

| Status | Meaning |
| - | - |
| `pending_payment` | Waiting for you to pay the Checkout link. |
| `payment_expired` | The link expired before payment. Ask the assistant to send again with the same request for a new link. |
| `scheduled` | Paid; the gift cards go out at the scheduled time. |
| `sent` | The gift cards were sent. |
| `failed` | Something went wrong. Contact [support@hoppier.com](mailto:support@hoppier.com). |
| `expired` | The send expired. |

A send made from another account answers "Forbidden", the same as an id that doesn't exist.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.