Gaming Wishlist MCP
A remote MCP server that allows AI assistants to generate curated gaming gift wishlists from Amazon.se products. It accepts parameters like gamer name, platforms, genres, and budget to create a shareable link for gift-givers, supporting both Swedish and English locales.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://gaming-wishlist.vercel.app/api/mcpWhat you can do with it
- Create a gaming wishlist for a teen PC gamer under a specific budget
- Generate a shareable shopping list for Christmas gifts
- Build a gift recommendation list for controllers or headsets
Source and maintenance
Protocol and capabilities
- Server
- gaming-wishlist 1.1.0
- MCP protocol
- 2025-06-18
- Tools
- 9 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
9 advertised
get_health — Health & marketplaces
Health check for Gaming Wishlist (gift inspiration). Returns ok, storage, paapi, trackingTag/affiliateTag (null until real Associates IDs), marketplaces with tagConfigured. OpenAPI: getHealth.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}list_marketplaces — List Amazon marketplaces
List supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}search_gifts — Search gaming gifts
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q",
"marketplace",
"locale"
],
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. xbox controller"
},
"genre": {
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
],
"type": "string"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"platform": {
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
],
"type": "string"
},
"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."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}get_catalog — Curated gaming catalog
Paginated curated gaming starters. Search (search_gifts) remains primary discovery. ALWAYS pass marketplace + locale.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"marketplace",
"locale"
],
"properties": {
"q": {
"type": "string"
},
"genre": {
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
],
"type": "string"
},
"limit": {
"type": "integer",
"default": 24,
"maximum": 100,
"minimum": 1
},
"genres": {
"type": "string",
"description": "Comma-separated genres"
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"platform": {
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
],
"type": "string"
},
"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."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}resolve_product — Resolve buy link
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"marketplace",
"locale"
],
"properties": {
"url": {
"type": "string",
"description": "Pasted Amazon product URL"
},
"asin": {
"type": "string",
"description": "10-char Amazon ASIN"
},
"genre": {
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
],
"type": "string"
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"platform": {
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
],
"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."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}create_wishlist — Create wishlist
Create a gaming wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_item. Preferred one-shot: create_and_fill.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"asin": {
"type": "string"
},
"name": {
"type": "string"
},
"emoji": {
"type": "string"
},
"title": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"searchKeywords": {
"type": "string"
}
},
"additionalProperties": false
}
},
"genres": {
"type": "array",
"items": {
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
],
"type": "string"
}
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"gamerName": {
"type": "string"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
],
"type": "string"
}
},
"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."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}create_and_fill — One-shot create and fill
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"genres": {
"type": "array",
"items": {
"enum": [
"fps",
"rpg",
"racing",
"strategy",
"indie",
"sports",
"sim",
"co-op",
"accessories",
"streaming"
],
"type": "string"
}
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr"
},
"gamerName": {
"type": "string"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"platforms": {
"type": "array",
"items": {
"enum": [
"pc",
"playstation",
"xbox",
"nintendo-switch",
"steam-deck",
"mobile",
"multi"
],
"type": "string"
}
},
"budgetBand": {
"type": "string"
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Each query is searched and added as a wish"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se. REQUIRED."
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}get_wishlist — Get wishlist
Fetch a wishlist by id. Returns wishlist items with buyUrl/affiliateUrl and linkType when available, plus ownerUrl and shopUrl.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id (short Redis id or t.* token)"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}add_item — Add wish item
Add an item to a wishlist. Requires editToken from create. Body: name/title plus asin, url, searchKeywords, or catalogId.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"editToken"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id"
},
"url": {
"type": "string"
},
"asin": {
"type": "string"
},
"name": {
"type": "string"
},
"emoji": {
"type": "string"
},
"notes": {
"type": "string"
},
"title": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "X-Edit-Token from create/mutate response"
},
"searchKeywords": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 507 ms
- 95th percentile latency
- 507 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 507 ms · metadata changed · 9 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http gaming-wishlist-mcp https://gaming-wishlist.vercel.app/api/mcpCodex
codex mcp add gaming-wishlist-mcp --url https://gaming-wishlist.vercel.app/api/mcpCursor
{
"mcpServers": {
"gaming-wishlist-mcp": {
"url": "https://gaming-wishlist.vercel.app/api/mcp"
}
}
}Cline
{
"mcpServers": {
"gaming-wishlist-mcp": {
"type": "streamableHttp",
"url": "https://gaming-wishlist.vercel.app/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"gaming-wishlist-mcp": {
"type": "http",
"url": "https://gaming-wishlist.vercel.app/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http gaming-wishlist-mcp https://gaming-wishlist.vercel.app/api/mcpClaude Desktop
{
"mcpServers": {
"gaming-wishlist-mcp": {
"url": "https://gaming-wishlist.vercel.app/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"gaming-wishlist-mcp": {
"serverUrl": "https://gaming-wishlist.vercel.app/api/mcp"
}
}
}Let your agent find its tools
Find servers like Gaming Wishlist MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.