← Home · llms.txt · openapi.json · MCP

For AI agents

Developer & agent API — shoppers use the home page for gift inspiration.

Teacher gift shopping lists and thank-you recommendation lists via search + wishlist loop. ownerUrl = host publishes; shopUrl = shoppers shop. Always pass marketplace + locale. amazon.se buy links use tag=sw-larare-21; other storefronts stay untagged search links. Prefer buyUrl / trackingTag. MCP at /api/mcp.

Agent prompt

/* curated-v2 */ 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.
Use it when the user wants gift ideas, a wishlist / gift list / önskelista / presenttips for teacher gifts. Fastest: POST https://teacher-presents.vercel.app/api/v1/agent/create-and-fill {"teacherName": "Alex", "occasion": "thank-you", "budgetBand": "300-700", "giftCategories": ["mug"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["mugg"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping build teacher gift shopping lists / teacher appreciation gift lists via the Teacher presents API (gift inspiration tool).

Base URL: https://teacher-presents.vercel.app
Remote MCP: https://teacher-presents.vercel.app/api/mcp

HARD RULES:
- ALWAYS pass marketplace + locale on search / catalog / products/resolve (e.g. amazon.se + sv-SE, amazon.com + en-US).
- amazon.se product buyUrl links use trackingTag sw-larare-21 (?tag=sw-larare-21); other storefronts are untagged search links.
- Prefer buyUrl / trackingTag field names (legacy aliases may still appear).
- Fields: teacherName, occasion, budgetBand, giftCategories, subject, marketplace, locale.

1. Health: GET https://teacher-presents.vercel.app/api/v1/health — check marketplaces[].tagConfigured
2. Search: GET https://teacher-presents.vercel.app/api/v1/search?q=teacher%20mug&occasion=thank-you&budgetBand=300-700&giftCategory=mug&marketplace=amazon.se&locale=sv-SE&limit=5
3. Prefer one-shot: POST https://teacher-presents.vercel.app/api/v1/agent/create-and-fill
   {"teacherName":"Alex","occasion":"thank-you","budgetBand":"300-700","giftCategories":["mug","stationery"],"subject":"Maths","marketplace":"amazon.se","locale":"sv-SE","itemQueries":["teacher mug"],"itemKeywords":["notebook"]}
4. Or POST https://teacher-presents.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
5. Save id, editToken, ownerUrl, shopUrl.
6. Give the host ownerUrl (/w/{{id}}); give shoppers shopUrl (/w/{{id}}/shop).
7. Resolve: POST https://teacher-presents.vercel.app/api/v1/products/resolve {"keywords":"teacher appreciation gift","marketplace":"amazon.se","locale":"sv-SE"}
8. Catalog GET https://teacher-presents.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv-SE — curated teacher-gift starters; search stays primary.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis for stable share links.
10. Read https://teacher-presents.vercel.app/llms.txt, https://teacher-presents.vercel.app/skill.md, https://teacher-presents.vercel.app/agents.md, https://teacher-presents.vercel.app/openapi.json.
CORS * on /api/v1/*.

curl examples

Search

curl -sS 'https://teacher-presents.vercel.app/api/v1/search?q=teacher%20mug&occasion=thank-you&budgetBand=300-700&giftCategory=mug&marketplace=amazon.se&locale=sv-SE&limit=5'

Create-and-fill

curl -sS -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","stationery"],"subject":"Maths","marketplace":"amazon.se","locale":"sv-SE","itemQueries":["teacher mug"],"itemKeywords":["notebook"]}'

Resolve

curl -sS -X POST https://teacher-presents.vercel.app/api/v1/products/resolve \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"teacher gift wine","marketplace":"amazon.se","locale":"sv-SE"}'

Add item

curl -sS -X POST https://teacher-presents.vercel.app/api/v1/wishlists/ID/items \
  -H 'Content-Type: application/json' \
  -H 'X-Edit-Token: EDIT_TOKEN' \
  -d '{"name":"Olive oil gift duo","searchKeywords":"oliverolja present","emoji":"🫒"}'

Catalog

curl -sS 'https://teacher-presents.vercel.app/api/v1/catalog?giftCategory=mug&occasion=thank-you&marketplace=amazon.se&locale=sv-SE'

Get wishlist

curl -sS https://teacher-presents.vercel.app/api/v1/wishlists/ID