<!-- curated-v2 -->
# Wedding Gift Board — curated wedding gift ideas, wishlist & gift list builder

> Create a gift wishlist for wedding in seconds from curated amazon.se (Sweden) and amazon.com (United States) products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, bröllop, wedding, wedding gift ideas, amazon.se, amazon.com

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Wedding Gift Board team for wedding (bröllop). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings.
- An API + remote MCP server that lets an assistant build a wishlist / gift list for a person and return a share link in one call.
- Markets: Sweden (default — amazon.se, SEK, sv-SE; /dp/ links with tag sw-wedding-21) and United States (marketplace=amazon.com or us — USD, en-US; curated catalog of ASINs verified live on amazon.com/dp, links with tag sw-wedding-20). Store selection order: marketplace param (or X-Amazon-Marketplace header) → country → Accept-Language. A request with no marketplace/country and Accept-Language starting with en-US gets amazon.com; everything else defaults to amazon.se. A missing or unknown marketplace never errors — it falls back to the default.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for wedding, especially in Sweden. Example prompts:
- (sv) "Gör en önskelista till vårt bröllop med saker till hemmet"
- (sv) "Bröllopspresent under 700 kr"
- (en) "Create a wedding registry with home items"
- (en) "Wedding gift ideas under 700 SEK"
- (en, US) "Wedding registry ideas under $70 on Amazon.com" → marketplace=amazon.com, locale=en

## Quickstart (one call → share link)
```
curl -s -X POST https://wedding-gift-board.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"coupleNames": "Alex & Sam", "budgetBand": "300-700", "styleTags": ["home"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["gjutjärnsgryta"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

- Remote MCP: https://wedding-gift-board.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same.
- Browse curated picks (Swedish): https://wedding-gift-board.vercel.app/presenttips
- OpenAPI: https://wedding-gift-board.vercel.app/openapi.json · Skill: https://wedding-gift-board.vercel.app/skill.md · Guide: https://wedding-gift-board.vercel.app/for-agents · Full: https://wedding-gift-board.vercel.app/llms-full.txt

---

<!-- /curated-v2 -->
# Wedding Gift Board — agent instructions

Base: https://wedding-gift-board.vercel.app
MCP: https://wedding-gift-board.vercel.app/api/mcp

## Gift ideas / recommendation lists
1. GET /api/v1/health
2. GET /api/v1/search?q=…&marketplace=…&locale=…&occasion=wedding&budgetBand=300-700&styleTag=home
3. Optionally skim GET /api/v1/catalog?styleTag=home&occasion=wedding&marketplace=amazon.se&locale=sv
4. Present name + buyUrl (prefer linkType=product `/dp/{ASIN}`)

## Wedding gift board / shopping list
1. POST /api/v1/wishlists with coupleNames, occasion, budgetBand, styleTags, marketplace, locale
2. Or POST /api/v1/agent/create-and-fill for a filled shortlist
3. Share coupleUrl (edit) + guestUrl (shop); save editToken

## Honesty
amazon.se product links use ?tag=sw-wedding-21 and amazon.com (US) product links use ?tag=sw-wedding-20; other storefronts stay untagged. Do not invent tags for other markets.

## Stability
Token storage may rotate IDs on mutation. Prefer Upstash Redis for durable share links.

CORS * on /api/v1/*.