Julklappsspel Gifts – hand-picked gift ideas

Working · 2.1 s

io.github.maggat/julklappsspel-giftsv1.2.0

Hand-picked gift ideas for Christmas gift games, turned into shareable wishlists fast.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://julklappsspel.vercel.app/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_wishlist_item

Add an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.

idstring, required

Wishlist id

editTokenstring, required

X-Edit-Token from create/mutate response

urlstring

asinstring

namestring

emojistring

titlestring

catalogIdstring

searchKeywordsstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

add_wishlist_item

Add an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.

Argument	Type	Description
id*	string	Wishlist id
url	string
asin	string
name	string
emoji	string
title	string
catalogId	string
editToken*	string	X-Edit-Token from create/mutate response
searchKeywords	string

Input schema (JSON)

{
  "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"
    },
    "title": {
      "type": "string"
    },
    "catalogId": {
      "type": "string"
    },
    "editToken": {
      "type": "string",
      "minLength": 1,
      "description": "X-Edit-Token from create/mutate response"
    },
    "searchKeywords": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

create_and_fill

One call: create a curated Christmas gift game (julklappsspel / secret santa) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. OpenAPI: agentCreateAndFill.

Argument	Type	Description
locale	string	User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English.
hostName	string
occasion	string
itemAsins	array
budgetBand	string	SE: under-200\|200-400\|400-700\|700-plus (kr). US (amazon.com): under-20\|20-35\|35-50\|50-plus (USD)
itemQueries	array	Each query is searched and added as a wish
marketplace	string	Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store.
itemKeywords	array
giftCategories	array

create_wishlist

Create a party gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.

Argument	Type	Description
items	array
locale	string	User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English.
hostName	string
occasion	string
budgetBand	string	SE: under-200\|200-400\|400-700\|700-plus (kr). US (amazon.com): under-20\|20-35\|35-50\|50-plus (USD)
marketplace	string	Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store.
giftCategories	array

Input schema (JSON)

{
  "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
      }
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English."
    },
    "hostName": {
      "type": "string"
    },
    "occasion": {
      "enum": [
        "julklappsspel",
        "white-elephant",
        "yankee-swap",
        "secret-santa",
        "office-christmas",
        "family-christmas",
        "friends-party",
        "other"
      ],
      "type": "string"
    },
    "budgetBand": {
      "type": "string",
      "description": "SE: under-200|200-400|400-700|700-plus (kr). US (amazon.com): under-20|20-35|35-50|50-plus (USD)"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store."
    },
    "giftCategories": {
      "type": "array",
      "items": {
        "enum": [
          "fun",
          "cozy",
          "kitchen",
          "beauty",
          "tech",
          "games",
          "gourmet",
          "home",
          "wellness",
          "practical",
          "luxury",
          "outdoor"
        ],
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}

get_catalog

Paginated curated party gift starters. Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. Search remains primary discovery. OpenAPI: getCatalog.

read-only

Argument	Type	Description
q	string	Full-text filter
limit	integer
locale	string	User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English.
offset	integer
occasion	string
marketplace	string	Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store.
giftCategory	string
giftCategories	array

Input schema (JSON)

get_health

Health check for Julklappsspel. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use this first. OpenAPI: getHealth.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_wishlist

Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.

read-only

Argument	Type	Description
id*	string	Wishlist id

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Wishlist id"
    }
  },
  "additionalProperties": false
}

list_marketplaces

List supported Amazon storefronts. Pick the user's marketplace: amazon.com for the US, amazon.se for Sweden. If you omit it, en-US requests get amazon.com and everything else amazon.se.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

resolve_product

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (trackingTag null until enrolled). Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. OpenAPI: resolveProduct.

read-only

Argument	Type	Description
url	string	Pasted Amazon product URL
asin	string	10-char Amazon ASIN
locale	string	User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English.
keywords	string	Search keywords if no ASIN
occasion	string
budgetBand	string	SE: under-200\|200-400\|400-700\|700-plus (kr). US (amazon.com): under-20\|20-35\|35-50\|50-plus (USD)
marketplace	string	Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store.
giftCategory	string

search_gifts

Search Amazon for party organizer / julklappsspel gifts on the user's marketplace. Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. OpenAPI: searchAmazon.

read-only

Argument	Type	Description
q*	string	Search query, e.g. doftljus present
limit	integer
locale	string	User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English.
occasion	string
marketplace	string	Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store.
giftCategory	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Search query, e.g. doftljus present"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en-US, sv, de. Optional; amazon.com always returns English."
    },
    "occasion": {
      "enum": [
        "julklappsspel",
        "white-elephant",
        "yankee-swap",
        "secret-santa",
        "office-christmas",
        "family-christmas",
        "friends-party",
        "other"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront for the end user, e.g. amazon.com (US, English, tag sw-julklappsspel-20) or amazon.se (Sweden, tag sw-julklappsspel-21). Optional: if omitted, en-US requests get amazon.com and everything else amazon.se. Never errors on a missing store."
    },
    "giftCategory": {
      "enum": [
        "fun",
        "cozy",
        "kitchen",
        "beauty",
        "tech",
        "games",
        "gourmet",
        "home",
        "wellness",
        "practical",
        "luxury",
        "outdoor"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}