<!-- curated-v2 -->
# Housewarming Kit — curated housewarming / moving in gift ideas, wishlist & gift list builder

> Create a gift wishlist for housewarming / moving in 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, inflyttningsfest, housewarming / moving in, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Housewarming Kit team for housewarming / moving in (inflyttningsfest). 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-housewarm-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for housewarming / moving in, especially in Sweden. Example prompts:
- (sv) "Inflyttningspresent till vänner som köpt första lägenheten"
- (sv) "Gör en lista med det viktigaste till nya hemmet"
- (en) "Housewarming gift for friends who bought their first apartment"
- (en) "Make a checklist for a new home"

## Quickstart (one call → share link)
```
curl -s -X POST https://housewarming-kit.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"householdName": "Alex & Sam", "moveType": "first-apartment", "budgetBand": "under-2k", "roomFocus": ["kitchen"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["skärbräda"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Housewarming Kit

> First-apartment kits, housewarming recommendation lists, and shareable shopping lists with Amazon purchase links on the storefront you choose. Built for shopping lists and recommendation lists.

Site: https://housewarming-kit.vercel.app
MCP: https://housewarming-kit.vercel.app/api/mcp

## Quick start
1. GET /api/v1/health — ok, storage, paapi, trackingTag, marketplaces[].tagConfigured
2. GET /api/v1/marketplaces — pick user's storefront
3. GET /api/v1/search?q=…&marketplace=…&locale=… — search-primary ideas for move-in essentials
4. GET /api/v1/catalog?marketplace=amazon.se&locale=sv-SE — 200+ curated starters
5. POST /api/v1/agent/create-and-fill — one-shot kit + items
6. Return ownerUrl + shopUrl

Agents MUST pass marketplace + locale. Prefer `buyUrl` / `trackingTag` fields. amazon.se product links include ?tag=sw-housewarm-21; other storefronts stay untagged. Never invent Associates placeholders or reuse Santa/girlfriend tags.

Full guide: /llms-full.txt · OpenAPI: /openapi.json · Skill: /skill.md · Agents: /agents.md