# Meadow5 promotions

> Live Meadow5 promotions. Offer data is open; each person gets their own unique single-use code, claimed directly through the MCP Server where allowed or after verifying their email.

## For people
- [Meadow5 Promo Page](https://promotions.meadow5.com/): Browse promotions and press "Get my code".

## For bots, agents and AI assistants
- [Bot Site feed (JSON)](https://promotions.meadow5.com/bots): Machine-readable promotions for Meadow5.
- [Bot Site feed (Markdown)](https://promotions.meadow5.com/bots.md): Same data as Markdown.
- [MCP Server](https://promotions.meadow5.com/mcp): Streamable HTTP MCP, no login needed.
- [AI catalog](https://promotions.meadow5.com/.well-known/ai-catalog.json): Machine discovery index.
- [Sitemap](https://promotions.meadow5.com/sitemap.xml): Promo Page and live promotion pages.

## Promotions
- [Get 30% off with Product Bundle - 3-4-2](https://promotions.meadow5.com/bots/f7e5a308-565d-4998-a125-d5499ead7aa3.md): 6 Nov 2026, 10:31 to 23 Nov 2034, 23:59 (Europe/London). One code per person for this promotion..
- [Get £5 off your order](https://promotions.meadow5.com/bots/deb55ba1-7fc8-4c97-9809-4c5a4900a4ef.md): 6 Nov 2026, 12:35 to 23 Nov 2034, 23:59 (Europe/London). One code per person for this promotion..

## Code claim rules
1. Every code is unique: each code is a fresh, single-use discount code minted for the one person who asked for it. No two people ever receive the same code and no static or shared codes are issued.
2. An email or one-time passcode (OTP) is not always required. Where a promotion allows it, compatible AI assistants can claim a unique code directly through the MCP Server; otherwise the person verifies their email with an OTP on a private claim link.
3. Only claim a code when the person has asked for one for a specific offer. Never claim codes pre-emptively, in bulk or on behalf of anyone else.
4. Codes are never published in the feeds and are never returned on a plain GET request.

## How to get a code with email verification
1. mint_claim_link — Only when the person has asked for a code for a specific offer, request the offer's mint_claim_link (GET or POST) or call the start_claim MCP tool. Never call it pre-emptively or for link previews. This never issues a code.
2. claim_url — Give the person claim_url as a clickable link, in one short sentence such as: "Open this private link to verify your email and get your code." Do not open it yourself, shorten it, or share it with anyone else. It is single-person and expires at expires_at.
3. otp — The person enters their email on the claim page and receives a 6-digit one-time code (OTP), then enters it there (or taps the email link, which fills it in). If they would rather stay in the chat, use start_claim with their email, ask them for the 6-digit code, then call verify_claim. Never ask for, repeat or store the OTP or email beyond that single call. Each OTP works once.
4. code_issued — The code appears on the claim page. If you are tracking the claim, call get_claim with claim_id to read code and merchant_url. Offer merchant_url (the shop link with the code already attached) as the way to shop.
Then: After the code is issued, let the person lead: answer their questions about terms or products, but do not push them to buy, do not start another claim unless they ask, and do not claim codes on their behalf for other offers.