<!-- curated-v2 -->
# Gaming Wishlist — curated gamers (gaming gifts) gift ideas, wishlist & gift list builder

> Create a gift wishlist for gamers (gaming 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, gaming, gamers (gaming gifts), amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Gaming Wishlist team for gamers (gaming gifts) (gaming). 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-gaming-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for gamers (gaming gifts), especially in Sweden. Example prompts:
- (sv) "Present till en tonåring som spelar på PC, max 700 kr"
- (sv) "Gör en gaming-önskelista till julen"
- (en) "Gift for a teen PC gamer under 700 SEK"
- (en) "Make a gaming wishlist for Christmas"

## Quickstart (one call → share link)
```
curl -s -X POST https://gaming-wishlist.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"gamerName": "Alex", "platforms": ["pc"], "genres": ["accessories"], "budgetBand": "300-700", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["gaming headset"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Gaming Wishlist — full agent guide

Live: https://gaming-wishlist.vercel.app
Service: gaming-wishlist
MCP: https://gaming-wishlist.vercel.app/api/mcp
Catalog: https://gaming-wishlist.vercel.app/api/v1/catalog

Tracking: amazon.se product /dp/ buyUrls include ?tag=sw-gaming-21. Other storefronts remain untagged. Never invent tags or reuse santawishli03-21.

## Use cases for agents
- Build a gaming wishlist or shopping list from curated catalog + open search
- Gift recommendation lists (controllers, headsets, keyboards, mice, chairs, monitors, streaming cams/mics, console games, gift cards)
- Return ownerUrl (gamer edits) + shopUrl (friends buy)

## Roles
- owner (gamer): /w/{id}
- shopper (friend): /w/{id}/shop
API returns ownerUrl + shopUrl.

## Endpoints (CORS *)
- GET /api/v1/health
- GET /api/v1/marketplaces
- GET /api/v1/search?q=&platform=&genre=&budgetBand=&marketplace=&locale=&limit=
- GET /api/v1/catalog?q=&platform=&genre=&genres=&budgetBand=&marketplace=&locale=
- POST /api/v1/wishlists  body: { gamerName, platforms[], genres[], budgetBand, marketplace, locale, items[] }
- GET/PATCH /api/v1/wishlists/{id}  (PATCH needs X-Edit-Token)
- POST /api/v1/wishlists/{id}/items  X-Edit-Token
- DELETE /api/v1/wishlists/{id}/items/{itemId}  X-Edit-Token
- POST /api/v1/agent/create-and-fill
- POST /api/v1/products/resolve  { asin|url, marketplace?, locale? }
- MCP Streamable HTTP: /api/mcp

## Marketplace + locale
Agents MUST pass marketplace (amazon.* domain or id) and locale matching the end user.
Curated ASINs are SE-oriented; other marketplaces use search deep-links.
Commissions only on amazon.se with tag sw-gaming-21.

## Storage
Redis (prefix gwwl:) when UPSTASH_* set; else compressed token IDs (may rotate on mutation).

## Field enums
- platforms: pc | playstation | xbox | nintendo-switch | steam-deck | mobile | multi
- genres: fps | rpg | racing | strategy | indie | sports | sim | co-op | accessories | streaming
- budgetBand: under-300 | 300-700 | 700-1500 | 1500-plus

## Docs
/llms.txt · /.well-known/llms.txt · /openapi.json · /skill.md · /agents.md · /for-agents · /.well-known/ai-plugin.json