Birthday Gift Finder – hand-picked gift ideas

Working · 3.2 s

io.github.maggat/birthday-giftsv1.2.0

Hand-picked gift ideas for birthdays that assistants turn into shareable wishlists fast. SE + US.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

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

https://birthday-gift-finder.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 birthday 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. Optional; amazon.com always answers in English.
ageBand	string
country	string	Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com).
occasion	string
itemAsins	array
budgetBand	string
itemQueries	array	Each query is searched and added as a wish
marketplace	string	Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing.
itemKeywords	array

create_wishlist

Create a birthday 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. Optional; amazon.com always answers in English.
ageBand	string
country	string	Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com).
occasion	string
budgetBand	string
marketplace	string	Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing.
recipientName	string
giftCategories	array

Input schema (JSON)

get_catalog

Paginated hand-picked birthday gifts with /dp buyUrls. marketplace=amazon.com returns the US catalog (English, USD or no price, tag sw-fodelsedag-20); amazon.se the Swedish one (tag sw-fodelsedag-21). OpenAPI: getCatalog.

read-only

Argument	Type	Description
q	string	Full-text filter
limit	integer
locale	string	User locale, e.g. en-US, sv. Optional; amazon.com always answers in English.
offset	integer
country	string	Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com).
occasion	string
marketplace	string	Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing.
giftCategory	string
giftCategories

get_health

Health check for Birthday Gift Finder. Returns ok, storage, defaultDomain (amazon.se), catalogs for amazon.se and amazon.com with their tracking tags, and marketplaces[]. 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. amazon.com (US) and amazon.se have hand-picked catalogs with /dp links. Pass marketplace on search/catalog/resolve when you know the user's store; otherwise 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 on amazon.com or amazon.se (tagged for both). Pass marketplace when known. 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. Optional; amazon.com always answers in English.
country	string	Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com).
keywords	string	Search keywords if no ASIN
occasion	string
budgetBand	string
marketplace	string	Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing.
giftCategory

search_gifts

Search birthday gifts on the user's Amazon storefront. Pass marketplace=amazon.com for US shoppers (English search), amazon.se for Sweden. Returns search links plus hand-picked catalogMatches with /dp links. OpenAPI: searchAmazon.

read-only

Argument	Type	Description
q*	string	Search query, e.g. cheese board
limit	integer
locale	string	User locale, e.g. en-US, sv. Optional; amazon.com always answers in English.
ageBand	string	Optional age band: kids\|teens\|20s\|30s\|40s-plus
country	string	Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com).
occasion	string
marketplace	string	Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing.
giftCategory	string

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "locale": { "type": "string", "minLength": 2, "description": "User locale, e.g. en-US, sv. Optional; amazon.com always answers in English." }, "ageBand": { "enum": [ "kids", "teens", "20s", "30s", "40s-plus" ], "type": "string" }, "country": { "type": "string", "minLength": 2, "description": "Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com)." }, "occasion": { "enum": [ "birthday", "surprise-party", "milestone-birthday", "kids-birthday", "other" ], "type": "string" }, "itemAsins": { "type": "array", "items": { "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 for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing." }, "itemKeywords": { "type": "array", "items": { "type": "string" } }, "recipientName": { "type": "string" }, "giftCategories": { "type": "array", "items": { "enum": [ "experiences", "tech", "fashion", "home", "wellness", "hobbies", "books", "gourmet", "kids-toys", "jewelry-accessories" ], "type": "string" } } }, "additionalProperties": false }

{ "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. Optional; amazon.com always answers in English." }, "ageBand": { "enum": [ "kids", "teens", "20s", "30s", "40s-plus" ], "type": "string" }, "country": { "type": "string", "minLength": 2, "description": "Optional ISO country of the end user, e.g. US or SE. Used when marketplace is omitted (US → amazon.com)." }, "occasion": { "enum": [ "birthday", "surprise-party", "milestone-birthday", "kids-birthday", "other" ], "type": "string" }, "budgetBand": { "type": "string" }, "marketplace": { "type": "string", "minLength": 2, "description": "Amazon storefront for the end user: amazon.com (US, English, USD) or amazon.se (Sweden), also accepts us / se. Recommended. If omitted: country, then the request's Accept-Language (en-US → amazon.com), else amazon.se. Never an error when missing." }, "recipientName": { "type": "string" }, "giftCategories": { "type": "array", "items": { "enum": [ "experiences", "tech", "fashion", "home", "wellness", "hobbies", "books", "gourmet", "kids-toys", "jewelry-accessories" ], "type": "string" } } }, "additionalProperties": false }