Girlfriend Gifts – hand-picked gift ideas

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

Girlfriend Gifts – hand-picked gift ideas is healthy: it completed an MCP handshake in 3648 ms and exposes 9 tools.

Hand-picked gift ideas for her (partner gifts), turned into shareable wishlists fast.

Endpoint: https://girlfriendgifts.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
Latency3648 ms
Last checked (UTC)2026-10-25T17:50:31.260Z

Health history

Checked (UTC)StatusLatencyError
2026-10-25T17:50:31.260ZHealthy3648

Tools (9)

get_healthHealth check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.
list_marketplacesList supported Amazon storefronts (id, domain, label, defaultLocale, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
search_giftsSearch Amazon for romantic partner gifts to build a recommendation or shopping list. Returns PA-API products when configured for the default storefront, otherwise romantic search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
get_catalogCurated girlfriend/wife gift catalog (170+ real amazon.se /dp ASINs) for building shopping lists and wishlists. On amazon.se items include /dp/ASIN buy links (tag sw-girlfriend-21 when configured); on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatal
resolve_productResolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or romantic search). ALWAYS pass marketplace + locale for the user. Does not invent Associates tags — uses server-configured tags per storefront. OpenAPI: resolveProduct.
create_wishlistCreate a girlfriend/wife gift list / wishlist for shopping-list building. Returns id, editToken, ownerUrl (she edits), shopUrl (he/agent shops), wishlist, storage. Save editToken for add_wishlist_item. If storage is token, later mutations may return a new id — always use the latest. OpenAPI: createW
create_and_fillPreferred agent path for list-building: create a gift wishlist and fill it with ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. Pass marketplace + locale. 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 gift list / wishlist (shopping-list building). Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. Prefer buyUrl in responses. OpenAPI: addWishlistItem.