<!-- 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 -->
# Skill: Gaming Wishlist

Gift inspiration tool for humans and AI agents — curated buy links for gaming wishlists, shopping lists, and gift recommendation lists across Amazon marketplaces.

Use this skill to suggest gaming gear and games and to create shareable wishlists with Amazon purchase links.

## When to use
- A gamer wants a wishlist or shopping list of controllers, headsets, chairs, Switch/Deck accessories, streaming gear, etc.
- Friends (or an AI agent) need a shop link to buy from that list
- You need curated starters plus open Amazon search (search remains available alongside catalog)
- Gift recommendation queries: game gift ideas, controller gifts, headset gifts

## Roles & URLs
- **owner** (gamer): `ownerUrl` → `/w/{id}?edit=…` — add/edit wishes
- **shopper** (friend / agent): `shopUrl` → `/w/{id}/shop?edit=…` — browse & buy

## Required agent args
Every search / create / resolve call SHOULD pass:
- `marketplace` — Amazon domain or id (e.g. `amazon.com`, `amazon.se`, `us`)
- `locale` — end-user locale (e.g. `en`, `sv-SE`)

## Steps
1. GET `/api/v1/search?q=&platform=&genre=&budgetBand=&marketplace=&locale=&limit=`
2. Prefer POST `/api/v1/agent/create-and-fill` with `gamerName`, `platforms[]`, `genres[]`, `budgetBand`, `marketplace`, `locale`, `itemAsins[]`, `itemKeywords[]`, `itemQueries[]`
3. Or POST `/api/v1/wishlists` then POST `.../items` with `{ name, asin }` or `{ name, url }`
4. GET `/api/v1/catalog` — curated gaming gift starters (150–300+ amazon.se ASINs)
5. POST `/api/v1/products/resolve` `{ asin }` or `{ url }` (+ marketplace/locale) → `buyUrl`
6. Return `ownerUrl` and `shopUrl` to the user
7. If `storage === "token"` and `id` changed, update bookmarks (prefer Upstash Redis for stable share links)

## 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 and /.well-known/llms.txt
- /llms-full.txt
- /openapi.json
- /for-agents
- /agents.md
- MCP: /api/mcp

## Tracking / buy links
amazon.se product links include `?tag=sw-gaming-21`. Other storefronts stay untagged. Never invent placeholders or reuse santawishli03-21. Responses dual-write `buyUrl` (+ legacy `affiliateUrl`) and `trackingTag` (+ legacy `affiliateTag`).
Base URL: https://gaming-wishlist.vercel.app

## MCP
Remote Streamable HTTP: https://gaming-wishlist.vercel.app/api/mcp