<!-- curated-v2 -->
# Host Gifts — curated host / hostess gifts gift ideas, wishlist & gift list builder

> Create a gift wishlist for host / hostess gifts in seconds from curated amazon.se products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, värdinnepresent, host / hostess gifts, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Host Gifts team for host / hostess gifts (värdinnepresent). 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.
- Market: Sweden (amazon.se, SEK, sv-SE). Buy links are amazon.se /dp/ links with tag sw-hostgifts-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for host / hostess gifts, especially in Sweden. Example prompts:
- (sv) "Värdinnepresent till middag på lördag, max 200 kr"
- (sv) "Tackpresent till värden efter en vinkväll"
- (en) "Hostess gift for a dinner party under 200 SEK"
- (en) "Thank-you gift for the host after a wine night"

## Quickstart (one call → share link)
```
curl -s -X POST https://host-gifts.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"hostName": "Alex", "occasion": "dinner-party", "budgetBand": "300-700", "giftCategories": ["wine", "gourmet"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["ostbricka"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Host Gifts — full agent guide

Product: host gift shopping lists / dinner-party host-gift recommendation lists / hostess gifts + table gear.
Framing: gift inspiration tool (not a storefront).
Roles: wishlist owner (host) + shopper (guest / agent).
URLs: ownerUrl=/w/{id}, shopUrl=/w/{id}/shop

## Buy links (honesty)
- amazon.se uses NEXT_PUBLIC_AMAZON_TAGS_JSON={"amazon.se":"sw-hostgifts-21"}; product buyUrl includes ?tag=sw-hostgifts-21.
- Other storefronts stay untagged search links — do not invent tags.
- Prefer field names buyUrl + trackingTag (legacy aliases may still appear).

## Required agent params
marketplace + locale on search, catalog, products/resolve (e.g. amazon.se + sv-SE).

## Fields
hostName, occasion, budgetBand, giftCategories, dietaryNotes, marketplace, locale

occasion: dinner-party | brunch | bbq | potluck | wine-night | holiday-dinner | birthday-dinner | thank-you-host | housewarming-dinner | other
giftCategories: wine | flowers | candles | tableware | serving | kitchen | gourmet | chocolate | plants | linens | experience | practical | luxury
dietaryNotes: vegetarian | vegan | gluten-free | nut-free | dairy-free | alcohol-free | kosher | halal | shellfish-free | none
budgetBand: under-300 | 300-700 | 700-1500 | 1500-plus

## Endpoints
### GET /api/v1/health
ok, storage, paapi, trackingTag, marketplaces[].tagConfigured, catalogCount

### GET /api/v1/search?q=&occasion=&budgetBand=&giftCategory=&dietaryNotes=&marketplace=&locale=&limit=
Host-gift query rewrite (dinner party / hostess / dietary). PA-API when configured else deep-link cards. Returns buyUrl / trackingTag.

### GET /api/v1/catalog?q=&occasion=&budgetBand=&giftCategory=&giftCategories=&marketplace=&locale=
Curated host-gift starters (amazon.se ASINs, linkType=product).

### POST /api/v1/wishlists
Body: { hostName?, recipientName?, occasion?, budgetBand?, giftCategories?, dietaryNotes?, marketplace?, locale?, items? }

### POST /api/v1/agent/create-and-fill
Body: hostName, occasion, budgetBand, giftCategories, dietaryNotes, marketplace, locale, itemAsins[], itemKeywords[], itemQueries[]

### POST /api/v1/products/resolve
Body: marketplace, locale, asin | url | keywords

### Wishlists
GET|PATCH /api/v1/wishlists/:id
POST|DELETE /api/v1/wishlists/:id/items[/:itemId]

### MCP
Remote Streamable HTTP: https://host-gifts.vercel.app/api/mcp
Local stdio: npm run mcp

CORS * on /api/v1/*.
Discovery: /llms.txt · /llms-full.txt · /openapi.json · /skill.md · /agents.md · /.well-known/ai-plugin.json · /for-agents