# Valentine's Day Gifts – hand-picked gift ideas

- Registry name: `io.github.maggat/valentines-gifts` · version 1.2.0
- Categories (automatic, keyword rules): Shops & products, Commerce & marketing, Health & fitness
- Authentication at last check: No auth
- Declared risk: Can write (some tools are not declared read-only)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.maggat%2Fvalentines-gifts
- Server page: https://mcpstation.net/s/io.github.maggat--valentines-gifts.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://valentines-day-gifts.vercel.app/api/mcp`

## Tools (as reported by the server, not verified)

- `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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html