← Home · llms.txt · openapi.json · skill.md · MCP /mcp

Dorm Kit for AI agents

Build dorm kits, shopping lists, and roommate recommendation lists. ownerUrl is for the student; roommateUrl is for a roommate or helper. Curated catalog items on amazon.se use product /dp/ buy links with tracking tag sw-dormkit-21.

Copy-paste agent prompt

/* curated-v2 */ 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.
Use it when the user wants gift ideas, a wishlist / gift list / önskelista / presenttips for moving into a student room / dorm. Fastest: POST https://dorm-kit.vercel.app/api/v1/agent/create-and-fill {"studentName": "Alex", "roomType": "shared", "budgetBand": "500-1500", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["påslakan"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping a student assemble a practical Dorm Kit shopping list / roommate recommendation list.

Base URL: https://dorm-kit.vercel.app

1. Health: GET https://dorm-kit.vercel.app/api/v1/health — note tagConfigured and trackingTag (amazon.se uses sw-dormkit-21).
2. Search: GET https://dorm-kit.vercel.app/api/v1/search?q=desk%20lamp&category=lighting&roomType=shared&budgetBand=under-500&marketplace=amazon.se&locale=sv&limit=5
3. Catalog starters: GET https://dorm-kit.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv&limit=20
4. Create: POST https://dorm-kit.vercel.app/api/v1/wishlists with {"studentName":"Alex","university":"North Campus","dormRules":["no-candles"],"roomType":"shared","budgetBand":"500-1500","marketplace":"amazon.se","locale":"sv","items":[{"name":"surge protector","asin":"B09VT9J66X"}]}
5. Save id, editToken, ownerUrl, roommateUrl (shopUrl is a compatibility alias).
6. Give ownerUrl to the student and roommateUrl to a roommate/helper.
7. Use /api/v1/agent/create-and-fill for itemQueries[], itemKeywords[], or itemAsins[].
8. amazon.se product /dp/ buyUrls include ?tag=sw-dormkit-21; other storefronts stay untagged. Never invent tags.
9. Prefer MCP at https://dorm-kit.vercel.app/mcp (OpenAI Apps/Plugins + Anthropic Connectors). Tools: search_kit_items, create_and_fill_kit, create_kit, add_kit_item, resolve_product, list_marketplaces, health. marketplace+locale required on search/create/resolve.

curl quickstart

Search

curl -sS 'https://dorm-kit.vercel.app/api/v1/search?q=desk%20lamp&category=lighting&marketplace=amazon.se&locale=sv&limit=5'

Create wishlist

curl -sS -X POST https://dorm-kit.vercel.app/api/v1/wishlists \
  -H 'Content-Type: application/json' \
  -d '{"studentName":"Alex","university":"North Campus","roomType":"shared","budgetBand":"500-1500","dormRules":["no-candles"],"marketplace":"amazon.se","locale":"sv","items":[{"name":"surge protector"}]}'

Endpoints

  • GET /api/v1/search?q=&category=&roomType=&budgetBand=&marketplace=&domain=&locale=&limit=
  • POST /api/v1/wishlists → ownerUrl + roommateUrl
  • POST /api/v1/agent/create-and-fill
  • GET /api/v1/catalog — dorm kit starters (product /dp/ on amazon.se)
  • GET /api/v1/health
  • GET/POST /mcp — remote MCP (OpenAI Apps/Plugins + Anthropic Connectors)

Discovery docs