get_health
Health & marketplaces
Health check for Mother's Day Gifts. Returns ok, storage, paapi, trackingTag (null until real Associates IDs), defaultDomain, catalogCount. Use this first to discover service status. OpenAPI: getHealth.
Takes no parameters.
list_marketplaces
List Amazon marketplaces
List supported Amazon storefronts via GET /api/v1/marketplaces (domain, label, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
Takes no parameters.
search_gifts
Search Mother's Day gifts
Search Amazon for Mother's Day / Mors dag gift ideas on the user's marketplace. Returns PA-API products when configured for the default storefront, otherwise Mother's Day search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale for the end user. OpenAPI: searchAmazon.
ParametersqrequiredlimitlocalerequiredinterestoccasionstyleTagbudgetBandmarketplacerequired
suggest_gifts
Suggest Mother's Day gifts
Alias of search_gifts — suggest Mother's Day gift ideas for a query on the user's marketplace. ALWAYS pass marketplace + locale.
ParametersqrequiredlimitlocalerequiredoccasionstyleTagbudgetBandmarketplacerequired
get_catalog
Curated Mother's Day catalog
Paginated curated Mother's Day gift starters. On amazon.se items may include /dp/ASIN links when ASINs exist; on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. Search (search_gifts) remains primary discovery. OpenAPI: getCatalog.
ParametersqidslimitlocalerequiredoffsetinterestoccasionstyleTagbudgetBandmarketplacerequired
resolve_product
Resolve buy link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or Mother's Day search). ALWAYS pass marketplace + locale. Does not invent Associates tags — omits tag= until server-configured real IDs. OpenAPI: resolveProduct.
ParametersurlasinlocalerequiredkeywordsoccasionstyleTagbudgetBandmarketplacerequiredpreferSearch
create_wishlist
Create Mother's Day gift list
Create a Mother's Day gift wishlist. Returns id, editToken, ownerUrl, shopUrl, 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.
ParametersitemslocaleoccasionstyleTagsbudgetBandmarketplacerelationshiprecipientName
create_and_fill
One-shot create and fill
One call: create a curated Mother's Day (Mors dag) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a Mother's Day wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. OpenAPI: agentCreateAndFill.
ParameterslocaleoccasionitemAsinsstyleTagsbudgetBanditemQueriesmarketplaceitemKeywordsrelationshiprecipientName
get_wishlist
Get gift list
Fetch a Mother's Day wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
Parametersidrequired
add_wishlist_item
Add gift list item
Add an item to a Mother's Day 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.
ParametersidrequiredurlasinnameemojititlecatalogIdeditTokenrequiredsearchKeywords