All servers · Shops & products · Health & fitness

Valentine's Day Gifts – hand-picked gift ideas

io.github.maggat/valentines-gifts · v1.2.0

Measured by MCP Station

Description written by the publisher, not verified

Hand-picked gift ideas for Valentine's Day, turned into shareable wishlists fast.

Connect

claude mcp add --transport http valentines-gifts https://valentines-day-gifts.vercel.app/api/mcp

{
  "mcpServers": {
    "valentines-gifts": {
      "url": "https://valentines-day-gifts.vercel.app/api/mcp"
    }
  }
}

Tools as reported by the server

• get_health
  Health check for Valentine's Day gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, tagConfigured, and marketplaces[] (domain, label, tagConfigured). Use this first to discover supported Amazon storefronts. OpenAPI: getHealth.
• list_marketplaces
  List supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Same data as get_health.marketplaces. Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
• search_gifts
  Search Amazon for Valentine's / romantic gift ideas on the user's marketplace. Returns PA-API products when configured for the default storefront, otherwise romantic-filtered search deep-link cards + catalogMatches. Prefer buyUrl / trackingTag in results. ALWAYS pass marketplace + locale for the end
• get_catalog
  Paginated curated Valentine gift starters. On amazon.se and amazon.com items include /dp/ASIN buy links (separate curated catalogs per store); on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. Search (search_gifts) remains primary discovery. OpenAPI: getCatalog.
• resolve_product
  Resolve 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 (omit tag= until real IDs are set). OpenAPI: resolveProduct.
• create_wishlist
  Create a Valentine's gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. Fields: recipientName, occasion, categories (not Santa childName/ageBand). Optional styleTags, budgetBand, relationship. If storage is token, later mutations may ret
• create_and_fill
  One call: create a curated Valentine's Day (Alla hjärtans dag) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a Valentine wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. Use recipientName, occasion, cat
• get_wishlist
  Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
• add_wishlist_item
  Add an item to a wishlist. Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Prefer buyUrl in responses. Token storage may return a new id — update bookmarks. OpenAPI: addWishlistItem.

Website · JSON · Text for agents · Registry updated 2026-10-25