Birthday Gift Finder – hand-picked gift ideas

io.github.maggat/birthday-gifts · v1.2.0 · ecommerce

Birthday Gift Finder – hand-picked gift ideas is healthy: it completed an MCP handshake in 1586 ms and exposes 9 tools.

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

Endpoint: https://birthday-gift-finder.vercel.app/api/mcp (streamable-http)

No repository listed · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count9
Latency1586 ms
Last checked (UTC)2026-10-25T17:50:28.546Z

Health history

Checked (UTC)StatusLatencyError
2026-10-25T17:50:28.546ZHealthy1586

Tools (9)

get_healthHealth 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.
list_marketplacesList 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.
search_giftsSearch 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.
get_catalogPaginated 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.
resolve_productResolve 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.
create_wishlistCreate a birthday gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.
create_and_fillOne 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.
get_wishlistFetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
add_wishlist_itemAdd an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.