<!-- curated-v2 -->
# Dorm Kit — curated moving into a student room / dorm gift ideas, wishlist & gift list builder

> Create a gift wishlist for moving into a student room / dorm 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, flytt till studentrum, moving into a student room / dorm, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Dorm Kit team for moving into a student room / dorm (flytt till studentrum). 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-dormkit-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for moving into a student room / dorm, especially in Sweden. Example prompts:
- (sv) "Gör en packlista till mitt studentrum i korridor"
- (sv) "Vad behöver jag när jag flyttar till studentlägenhet?"
- (en) "Make a dorm room shopping list for a shared room"
- (en) "What do I need when moving into a student room?"

## Quickstart (one call → share link)
```
curl -s -X POST https://dorm-kit.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"studentName": "Alex", "roomType": "shared", "budgetBand": "500-1500", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["påslakan"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Skill: Dorm Kit

Use this skill to build **student dorm / back-to-school shopping lists**, dorm kits, and roommate recommendation lists with Amazon buy links (product `/dp/` when ASIN known; search deep-links otherwise).

## When to use
- Shareable dorm packing kit (student adds items; roommate/family shops)
- Back-to-school / campus essentials with curated buy links
- Roommate recommendation lists across amazon.se / .com / .de / .co.uk / .fr and other storefronts

## Roles & URLs
- **student (owner)**: `ownerUrl` → `/w/{id}?edit=…` — add/edit kit items
- **roommate / helper**: `roommateUrl` (`shopUrl` alias) → `/w/{id}/shop?edit=…` — search & buy

## CRITICAL — marketplace + locale
Agents MUST pass the user's marketplace (or domain) and locale on every search/catalog/resolve call so buy links open the correct amazon.* host.
- Query: `marketplace=amazon.se` (or `se`) and `locale=sv` (or `en`/`de`/`fr`/`es`)
- Or header: `X-Amazon-Marketplace: amazon.de`
- Curated catalog ASINs are amazon.se-oriented: on amazon.se links use `/dp/{ASIN}?tag=sw-dormkit-21`; on other marketplaces catalog items become untagged search deep-links.
- Do not invent tags or reuse other verticals' tags.

## Steps
1. GET `/api/v1/health` — note `tagConfigured`, `trackingTag`
2. Prefer POST `/api/v1/agent/create-and-fill` with `studentName`, `university`, `roomType`, `budgetBand`, `dormRules[]`, `itemAsins[]`, `itemKeywords[]`, `itemQueries[]`, `marketplace`, `locale`
3. Or GET `/api/v1/search?q=&category=&roomType=&budgetBand=&limit=&marketplace=&locale=` then POST `/api/v1/wishlists` + items
4. GET `/api/v1/catalog?limit=&offset=&marketplace=&locale=` — curated dorm starters; **search is primary**
5. POST `/api/v1/products/resolve` `{ asin|url|keywords, marketplace, locale }` → `buyUrl`
6. Return `ownerUrl` and `roommateUrl` to the user
7. Remote MCP: `GET/POST /mcp` (Streamable HTTP) for OpenAI Apps/Plugins and Anthropic Connectors

## Enums
- category: bedding | lighting | storage | desk | laundry | bath | kitchen | tech | safety | decor | cleaning | other
- budgetBand: under-500 | 500-1500 | 1500-3000 | 3000-plus
- roomType: single | shared | suite | studio

Base: https://dorm-kit.vercel.app
MCP: https://dorm-kit.vercel.app/mcp