<!-- 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 -->
# Agents — Gaming Wishlist

Base URL: https://gaming-wishlist.vercel.app
MCP: https://gaming-wishlist.vercel.app/api/mcp
Catalog: https://gaming-wishlist.vercel.app/api/v1/catalog

Use for gaming wishlists, shopping lists, and gift recommendation lists (controllers, headsets, keyboards, games, streaming gear).

## Create & fill
```bash
curl -sS -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":"700-1500","marketplace":"amazon.se","locale":"sv","itemQueries":["wireless gaming headset"],"itemKeywords":["mechanical keyboard"]}'
```

Save `id`, `editToken`, `ownerUrl`, `shopUrl`.

## Search
```bash
curl -sS 'https://gaming-wishlist.vercel.app/api/v1/search?q=controller&platform=playstation&genre=accessories&marketplace=amazon.se&locale=sv&limit=5'
```

## Catalog
```bash
curl -sS 'https://gaming-wishlist.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv&genre=accessories'
```

## Resolve product
```bash
curl -sS -X POST https://gaming-wishlist.vercel.app/api/v1/products/resolve \
  -H 'content-type: application/json' \
  -d '{"url":"https://www.amazon.se/dp/B0EXAMPLE0","marketplace":"amazon.se","locale":"sv"}'
```

amazon.se buyUrls include `?tag=sw-gaming-21`. Other storefronts untagged. Never invent tags.

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