Gaming Wishlist – hand-picked gift ideas
Hand-picked gift ideas for gamers that assistants turn into shareable wishlists fast. SE + US.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"gaming-gifts": {
"url": "https://gaming-wishlist.vercel.app/api/mcp"
}
}
}Remote endpoints
https://gaming-wishlist.vercel.app/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢get_health
Health check for Gaming Wishlist (gift inspiration). Returns ok, storage, paapi, trackingTag/affiliateTag (null until real Associates IDs), marketplaces with tagConfigured. OpenAPI: getHealth.
Input Schema
{
"type": "object",
"properties": {}
}🟢list_marketplaces
List supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
Input Schema
{
"type": "object",
"properties": {}
}🟢search_gifts(q, marketplace, locale, platform, genre, ...)
Search Amazon for gaming gear on the user's marketplace. Returns PA-API products when configured, otherwise gaming-filtered search deep-link cards. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. xbox controller"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"platform": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
]
},
"genre": {
"type": "string",
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
]
},
"budgetBand": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"required": [
"q",
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_catalog(marketplace, locale, q, platform, genre, ...)
Paginated curated gaming starters. Search (search_gifts) remains primary discovery. ALWAYS pass marketplace + locale.
Input Schema
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"q": {
"type": "string"
},
"platform": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
]
},
"genre": {
"type": "string",
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
]
},
"genres": {
"type": "string",
"description": "Comma-separated genres"
},
"budgetBand": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_product(marketplace, locale, asin, url, keywords, ...)
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (also dual-writes affiliateUrl). Does not invent tracking tags — omits ?tag= until real IDs are configured. ALWAYS pass marketplace + locale.
Input Schema
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"asin": {
"type": "string",
"description": "10-char Amazon ASIN"
},
"url": {
"type": "string",
"description": "Pasted Amazon product URL"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"platform": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
]
},
"genre": {
"type": "string",
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
]
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_wishlist(gamerName, platforms, genres, budgetBand, marketplace, ...)
Create a gaming wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_item. Preferred one-shot: create_and_fill.
Input Schema
{
"type": "object",
"properties": {
"gamerName": {
"type": "string"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
]
}
},
"genres": {
"type": "array",
"items": {
"type": "string",
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
]
}
},
"budgetBand": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_and_fill(gamerName, platforms, genres, budgetBand, marketplace, ...)
One call: create a curated gamers (gaming gifts) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl.
Input Schema
{
"type": "object",
"properties": {
"gamerName": {
"type": "string"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
]
}
},
"genres": {
"type": "array",
"items": {
"type": "string",
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
]
}
},
"budgetBand": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Each query is searched and added as a wish"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_wishlist(id)
Fetch a wishlist by id. Returns wishlist items with buyUrl/affiliateUrl and linkType when available, plus ownerUrl and shopUrl.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id (short Redis id or t.* token)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_item(id, editToken, name, title, asin, ...)
Add an item to a wishlist. Requires editToken from create. Body: name/title plus asin, url, searchKeywords, or catalogId.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "X-Edit-Token from create/mutate response"
},
"name": {
"type": "string"
},
"title": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
},
"notes": {
"type": "string"
}
},
"required": [
"id",
"editToken"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence