<!-- curated-v2 -->
# Julklappsspel — curated Christmas gift game (julklappsspel / secret santa) gift ideas, wishlist & gift list builder

> Create a gift wishlist for Christmas gift game (julklappsspel / secret santa) in seconds from curated amazon.se products (or the English US catalog on amazon.com) — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, julklappsspel, Christmas gift game (julklappsspel / secret santa), amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Julklappsspel team for Christmas gift game (julklappsspel / secret santa) (julklappsspel). 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-julklappsspel-21.
- Market: United States (amazon.com, USD, en-US) — pass marketplace=amazon.com. Returns the US white elephant / Secret Santa gift-idea catalog (ids u001…, budgetBands under-20|20-35|35-50|50-plus). Buy links use ?tag=sw-julklappsspel-20 (/dp/{ASIN} when an ASIN is verified for amazon.com, otherwise amazon.com search links). Human US page: /gift-ideas (or ?country=US).

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for Christmas gift game (julklappsspel / secret santa), especially in Sweden. Example prompts:
- (sv) "Hitta 5 presenter till julklappsspelet för max 200 kr"
- (sv) "Gör en önskelista för hemlig tomte på jobbet"
- (en) "Find 5 gifts for a Swedish Christmas gift game under 200 SEK"
- (en) "Make a secret santa gift list for my office"

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

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

---

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

Julklappsspel helps party organizers (hosts) and guest shoppers pick Christmas gift-game presents — julklappsspel, white elephant, yankee swap, secret santa, office/family/friends Christmas parties.

## Roles
- hostName = party organizer who publishes a gift list / budget
- Guests shop via shopUrl and bring gifts to the game

## Base URL
https://julklappsspel.vercel.app

## Remote MCP
https://julklappsspel.vercel.app/api/mcp

## Associates
amazon.se product /dp/ buyUrl links use trackingTag sw-julklappsspel-21 (?tag=sw-julklappsspel-21).
amazon.com (US) links use trackingTag sw-julklappsspel-20. Other storefronts stay untagged (search links without ?tag=).
Never use other vertical tags.

## Domain fields
- hostName (string)
- occasion / gameType: julklappsspel | white-elephant | yankee-swap | secret-santa | office-christmas | family-christmas | friends-party | other
- budgetBand: under-200 | 200-400 | 400-700 | 700-plus
- giftCategories: fun | cozy | kitchen | beauty | tech | games | gourmet | home | wellness | practical | luxury | outdoor
- marketplace (required for agents, e.g. amazon.se)
- locale (required for agents, e.g. sv-SE)

## Endpoints
GET /api/v1/health
GET /api/v1/search?q=&occasion=&budgetBand=&giftCategory=&marketplace=&locale=&limit=
GET /api/v1/catalog?marketplace=&locale=&giftCategory=&occasion=&budgetBand=
POST /api/v1/wishlists
POST /api/v1/agent/create-and-fill
POST /api/v1/products/resolve
GET|PATCH|DELETE /api/v1/wishlists/:id
POST /api/v1/wishlists/:id/items
DELETE /api/v1/wishlists/:id/items/:itemId

Human UI: /  owner: /w/[id]  shop: /w/[id]/shop
Agent docs: /for-agents /llms.txt /skill.md /agents.md /openapi.json /.well-known/ai-plugin.json

Redis key prefix: jks:
Catalog mode: asin / linkType=product (/dp/ with ?tag= on amazon.se)