Santa Wishlist – hand-picked gift ideas

Working · 2.1 s

io.github.maggat/santa-giftsv1.2.0

Hand-picked gift ideas for kids' Christmas, 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://santa-wish.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. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. 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

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 kids' Christmas gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call (or give only ageBand/interests to auto-fill curated picks). Pass marketplace=amazon.com for US shoppers (amazon.se default). Returns id, editToken, shopUrl, ownerUrl, parentUrl, kidUrl. OpenAPI: agentCreateAndFill.

Argument	Type	Description
count	integer	If no items are given, auto-fill this many curated picks for the age band/interests (default 6)
locale	string	User locale, e.g. en-US, sv, de. en-US switches to amazon.com when marketplace is omitted.
ageBand	string
country	string	ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)
childName	string
interests	array
itemAsins	array
itemQueries	array	Each query is searched and added as a wish
marketplace	string

create_wishlist

Create a kids Christmas wishlist. Pass marketplace (amazon.com for US, amazon.se default) so buy links match the shopper's store. Returns id, editToken, shopUrl, ownerUrl, parentUrl, kidUrl, wishlist, storage. Save editToken for add_wishlist_item. If storage is token, later mutations may return a new id — always use the latest. OpenAPI: createWishlist.

Argument	Type	Description
items	array
ageBand	string
country	string	ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)
childName	string
interests	array
marketplace	string	Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com.

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
      }
    },
    "ageBand": {
      "enum": [
        "0-2",
        "3-5",
        "6-8",
        "9-12"
      ],
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)"
    },
    "childName": {
      "type": "string"
    },
    "interests": {
      "type": "array",
      "items": {
        "enum": [
          "toys",
          "books",
          "sports",
          "craft",
          "tech",
          "outdoor",
          "games"
        ],
        "type": "string"
      }
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com."
    }
  },
  "additionalProperties": false
}

get_catalog

Paginated hand-picked kids gift catalog (~600 on amazon.se, ~560 English items on amazon.com). amazon.se: /dp product links with SEK price hints. amazon.com: English names, tagged amazon.com search links, no SEK prices (catalogMode search-ideas). OpenAPI: getCatalog.

read-only

Argument	Type	Description
q	string	Full-text filter
ids	string	Comma-separated catalog ids
limit	integer
locale	string	User locale, e.g. en-US, sv, de. en-US switches to amazon.com when marketplace is omitted.
offset	integer
ageBand	string
country	string	ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)
interest	string
interests	string	Comma-separated interests
marketplace

get_health

Health check for Santa Wishlist gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). amazon.se (default) and amazon.com (US) are the primary storefronts. OpenAPI: getHealth.

read-only

No arguments.

Input schema (JSON)

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

get_wishlist

Fetch a wishlist by id. Returns items with buyUrl/linkType for the list's store (override with marketplace), plus shopUrl, parentUrl and kidUrl. OpenAPI: getWishlist.

read-only

Argument	Type	Description
id*	string	Wishlist id (short Redis id or t.* token)
marketplace	string	Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com.

Input schema (JSON)

{
  "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)"
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com."
    }
  },
  "additionalProperties": false
}

list_marketplaces

List supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Same data as get_health.marketplaces. Pass the user's marketplace (amazon.com for US, amazon.se for Sweden) on search/catalog/resolve/create.

read-only

No arguments.

Input schema (JSON)

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

resolve_product

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl for the user's store (amazon.com or amazon.se). Curated catalog ASINs on amazon.com become English search links. With no input it returns a default kids gift search. 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. en-US switches to amazon.com when marketplace is omitted.
ageBand	string
country	string	ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)
category	string
keywords	string	Search keywords if no ASIN
marketplace	string	Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com.

search_gifts

Search kids Christmas gift ideas for the user's store (amazon.com for US, amazon.se default). Returns kids-filtered search link cards + curated catalogMatches (English on amazon.com). q is optional. OpenAPI: searchAmazon.

read-only

Argument	Type	Description
q	string	Search query, e.g. LEGO City (default: christmas gifts for kids)
limit	integer
locale	string	User locale, e.g. en-US, sv, de. en-US switches to amazon.com when marketplace is omitted.
ageBand	string
country	string	ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)
interest	string	Category filter
marketplace	string	Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query, e.g. LEGO City (default: christmas gifts for kids)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "description": "User locale, e.g. en-US, sv, de. en-US switches to amazon.com when marketplace is omitted."
    },
    "ageBand": {
      "enum": [
        "0-2",
        "3-5",
        "6-8",
        "9-12"
      ],
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO country of the shopper, e.g. US or SE (used when marketplace is omitted)"
    },
    "interest": {
      "enum": [
        "toys",
        "books",
        "sports",
        "craft",
        "tech",
        "outdoor",
        "games"
      ],
      "type": "string",
      "description": "Category filter"
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (US) or amazon.se (Sweden, default); also uk, de, fr… Order: marketplace → country → locale/Accept-Language (en-US ⇒ amazon.com) → amazon.se. amazon.se returns curated /dp product links; amazon.com returns English search links tagged for amazon.com."
    }
  },
  "additionalProperties": false
}