<!-- curated-v2 -->
# Lärarpresenter — curated teacher gifts gift ideas, wishlist & gift list builder

> Create a gift wishlist for teacher gifts 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, present till lärare, teacher gifts, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Lärarpresenter team for teacher gifts (present till lärare). 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-larare-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for teacher gifts, especially in Sweden. Example prompts:
- (sv) "Present till fröken på skolavslutningen"
- (sv) "Julpresent till lärare från hela klassen"
- (en) "End-of-year gift for my child's teacher"
- (en) "Christmas gift for a teacher from the whole class"

## Quickstart (one call → share link)
```
curl -s -X POST https://teacher-presents.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"teacherName": "Alex", "occasion": "thank-you", "budgetBand": "300-700", "giftCategories": ["mug"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["mugg"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

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

Product: teacher appreciation gift shopping lists / lärarpresenter / teacher presents.
Site: https://teacher-presents.vercel.app
Roles: wishlist owner (builds list for a teacher / class) + shopper.

## Endpoints
### GET /api/v1/health
### GET /api/v1/catalog?marketplace=&locale=&occasion=&giftCategory=&budgetBand=
Curated amazon.se /dp/ ASINs (catalogMode asin, linkType=product).
### GET /api/v1/search?q=&occasion=&budgetBand=&giftCategory=&marketplace=&locale=&limit=
Teacher-gift query rewrite. PA-API when configured else deep-link cards. Returns buyUrl / trackingTag.
### POST /api/v1/wishlists
Body: { teacherName?, hostName?, recipientName?, occasion?, budgetBand?, giftCategories?, subject?, notes?, marketplace?, locale?, items? }
### POST /api/v1/agent/create-and-fill
Body: teacherName, occasion, budgetBand, giftCategories, subject, marketplace, locale, itemAsins[], itemKeywords[], itemQueries[]
### POST /api/v1/products/resolve
### Remote MCP: /api/mcp

## Enums
occasion: end-of-year | teachers-day | thank-you | christmas | graduation | first-day | birthday | just-because | other
giftCategories: stationery | mug | plant | spa | book | tech | classroom | personalized | chocolate | candle | tote | jewelry | home | practical | luxury
budgetBand: under-300 | 300-700 | 700-1500 | 1500-plus

## Tracking
amazon.se → tag sw-larare-21 only. Never invent tags.