Host Gifts – hand-picked gift ideas

Working · 2.5 s

io.github.maggat/host-giftsv1.2.0

Hand-picked gift ideas for dinner hosts 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://host-gifts.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 host / hostess gifts 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, sv, de, fr, es
hostName	string
occasion	string
itemAsins	array
budgetBand	string
itemQueries	array	Each query is searched and added as a wish
marketplace	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
dietaryNotes	array
itemKeywords	array
giftCategories	array

Input schema (JSON)

create_wishlist

Create a host 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, sv, de, fr, es
hostName	string
occasion	string
budgetBand	string
marketplace	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
dietaryNotes	array
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, sv, de, fr, es"
    },
    "hostName": {
      "type": "string"
    },
    "occasion": {
      "enum": [
        "dinner-party",
        "brunch",
        "bbq",
        "potluck",
        "wine-night",
        "holiday-dinner",
        "birthday-dinner",
        "thank-you-host",
        "housewarming-dinner",
        "other"
      ],
      "type": "string"
    },
    "budgetBand": {
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
    },
    "dietaryNotes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "giftCategories": {
      "type": "array",
      "items": {
        "enum": [
          "wine",
          "flowers",
          "candles",
          "tableware",
          "serving",
          "kitchen",
          "gourmet",
          "chocolate",
          "plants",
          "linens",
          "experience",
          "practical",
          "luxury"
        ],
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}

get_catalog

Paginated curated host gift starters. ALWAYS pass marketplace + locale. 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, sv, de, fr, es
offset	integer
occasion	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
giftCategory	string
giftCategories	string	Comma-separated gift categories

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "marketplace",
    "locale"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Full-text filter"
    },
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 100,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "occasion": {
      "enum": [
        "dinner-party",
        "brunch",
        "bbq",
        "potluck",
        "wine-night",
        "holiday-dinner",
        "birthday-dinner",
        "thank-you-host",
        "housewarming-dinner",
        "other"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
    },
    "giftCategory": {
      "enum": [
        "wine",
        "flowers",
        "candles",
        "tableware",
        "serving",
        "kitchen",
        "gourmet",
        "chocolate",
        "plants",
        "linens",
        "experience",
        "practical",
        "luxury"
      ],
      "type": "string"
    },
    "giftCategories": {
      "type": "string",
      "description": "Comma-separated gift categories"
    }
  },
  "additionalProperties": false
}

get_health

Health check for Host Gifts. Returns ok, storage, paapi, trackingTag (null until enrolled), 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. Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.

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). ALWAYS pass marketplace + locale. 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, sv, de, fr, es
keywords	string	Search keywords if no ASIN
occasion	string
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
giftCategory	string

Input schema (JSON)

{
  "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"
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "keywords": {
      "type": "string",
      "description": "Search keywords if no ASIN"
    },
    "occasion": {
      "enum": [
        "dinner-party",
        "brunch",
        "bbq",
        "potluck",
        "wine-night",
        "holiday-dinner",
        "birthday-dinner",
        "thank-you-host",
        "housewarming-dinner",
        "other"
      ],
      "type": "string"
    },
    "budgetBand": {
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
    },
    "giftCategory": {
      "enum": [
        "wine",
        "flowers",
        "candles",
        "tableware",
        "serving",
        "kitchen",
        "gourmet",
        "chocolate",
        "plants",
        "linens",
        "experience",
        "practical",
        "luxury"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

search_gifts

Search Amazon for hostess / dinner-party gifts on the user's marketplace. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.

read-only

Argument	Type	Description
q*	string	Search query, e.g. cheese board
limit	integer
locale*	string	User locale, e.g. en, sv, de, fr, es
occasion	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
dietaryNotes	string	Comma-separated dietary notes
giftCategory	string

Input schema (JSON)

{
  "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. cheese board"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "occasion": {
      "enum": [
        "dinner-party",
        "brunch",
        "bbq",
        "potluck",
        "wine-night",
        "holiday-dinner",
        "birthday-dinner",
        "thank-you-host",
        "housewarming-dinner",
        "other"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
    },
    "dietaryNotes": {
      "type": "string",
      "description": "Comma-separated dietary notes"
    },
    "giftCategory": {
      "enum": [
        "wine",
        "flowers",
        "candles",
        "tableware",
        "serving",
        "kitchen",
        "gourmet",
        "chocolate",
        "plants",
        "linens",
        "experience",
        "practical",
        "luxury"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}