Housewarming Kit – hand-picked gift ideas

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

Housewarming Kit – hand-picked gift ideas is healthy: it completed an MCP handshake in 3354 ms and exposes 9 tools.

Hand-picked gift ideas for housewarmings, turned into shareable wishlists fast.

Endpoint: https://housewarming-kit.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
Latency3354 ms
Last checked (UTC)2026-10-25T17:50:31.486Z

Health history

Checked (UTC)StatusLatencyError
2026-10-25T17:50:31.486ZHealthy3354

Tools (9)

get_healthHealth check for Housewarming Kit gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use first to discover storefronts. OpenAPI: getHealth.
list_marketplacesList supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve. tagConfigured is false until real Associates IDs exist (buyUrl omits ?tag=).
search_kitsSearch Amazon for first-apartment / housewarming essentials on the user's marketplace. Returns PA-API products when configured, otherwise search deep-link cards (buyUrl, trackingTag) + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
get_catalogPaginated curated housewarming starters. On amazon.se items may include /dp/ASIN buy links; elsewhere catalogMode is search-ideas. ALWAYS pass marketplace + locale. Search remains primary. OpenAPI: getCatalog.
resolve_productResolve an ASIN, pasted Amazon /dp/ URL, or keywords to buyUrl (product /dp or apartment search). ALWAYS pass marketplace + locale. Does not invent Associates tags — trackingTag is null until configured. OpenAPI: resolveProduct.
create_kitCreate a housewarming / first-apartment kit list. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_kit_item. Prefer create_and_fill for one-shot. OpenAPI: createWishlist.
create_and_fillOne call: create a curated housewarming / moving in gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a kit and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. ALWAYS pass marketplace + locale. OpenAPI: agentCreateAndF
get_kitFetch a kit by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
add_kit_itemAdd an item to a kit. 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.