<!-- curated-v2 -->
# Santa Wish (Tomtens önskelista) — curated kids' Christmas gift ideas, wishlist & gift list builder (amazon.com + amazon.se)

> Create a kids' Christmas gift wishlist in seconds from hand-picked products — US shoppers get amazon.com links, Swedish shoppers get amazon.se product links — with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, Christmas gifts for kids, Santa list, presenttips, önskelista, presentlista, jul (barn), amazon.com, amazon.se

## What it is
- A catalog of carefully selected, hand-picked gift ideas for kids' Christmas (~600 items on amazon.se; ~560 English items on amazon.com). 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.

## Stores (marketplace)
- **amazon.com (United States)** — pass `marketplace=amazon.com` (or `country=US`, or send `Accept-Language: en-US`). English product names, no SEK prices, buy links are amazon.com search links tagged `sw-santawish-20` (`linkType: "search"`).
- **amazon.se (Sweden, default)** — `marketplace=amazon.se` or no hint. Swedish names, approx. SEK prices, buy links are amazon.se `/dp/ASIN` links tagged `santawishli03-21`.
- Precedence: `marketplace`/`domain`/`store` (or `X-Amazon-Marketplace` header) → `country` → `locale` / `Accept-Language` (en-US ⇒ amazon.com) → amazon.se. Other storefronts (uk, de, …) get search links.
- Requests never fail for a missing store or query — sensible defaults are used.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for kids' Christmas (US or Sweden). Example prompts:
- (en) "Create a Santa wishlist for my 7-year-old who loves LEGO"
- (en) "Christmas gift ideas for a 4-year-old under $30 on Amazon"
- (sv) "Gör en önskelista till tomten för min 7-åring som gillar LEGO"
- (sv) "Julklappstips till en 4-åring under 300 kr"

## Quickstart (one call → share link)
US (amazon.com):
```
curl -s -X POST https://santa-wish.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"childName": "Emma", "ageBand": "6-8", "interests": ["toys"], "marketplace": "amazon.com", "locale": "en-US", "itemQueries": ["LEGO"]}'
```
Sweden (amazon.se):
```
curl -s -X POST https://santa-wish.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"childName": "Freja", "ageBand": "6-8", "interests": ["toys"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["LEGO"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit), `shopUrl` (share this with gift-givers), `marketplace`. Give the user the `shopUrl`.

- Catalog (US): https://santa-wish.vercel.app/api/v1/catalog?marketplace=amazon.com&limit=24 · (SE): https://santa-wish.vercel.app/api/v1/catalog?marketplace=amazon.se&limit=24
- Remote MCP: https://santa-wish.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same; pass `marketplace`.
- Browse curated picks (Swedish): https://santa-wish.vercel.app/presenttips
- OpenAPI: https://santa-wish.vercel.app/openapi.json · Skill: https://santa-wish.vercel.app/skill.md · Guide: https://santa-wish.vercel.app/for-agents · Full: https://santa-wish.vercel.app/llms-full.txt · MCP manifest: https://santa-wish.vercel.app/.well-known/mcp.json

---

<!-- /curated-v2 -->
# Agents guide — Santa Wishlist

Base: https://santa-wish.vercel.app

**Pass `marketplace` for your user** (`amazon.com` for US, `amazon.se` for Sweden — default) on `/api/v1/search`, `/api/v1/catalog`, `/api/v1/products/resolve` and wishlist creation (query, body or `X-Amazon-Marketplace` header). en-US / country=US auto-selects amazon.com. amazon.se gets /dp links; amazon.com gets English search links tagged sw-santawish-20. See `/skill.md`, `/llms.txt`, `/llms-full.txt`, `/openapi.json`.

Health: GET /api/v1/health → catalogCount, marketplaces[].

MCP (Streamable HTTP): https://santa-wish.vercel.app/api/mcp — see docs/mcp.md and /skill.md.