io.github.maggat/santa-gifts · v1.2.0 · ecommerce
Santa Wishlist – hand-picked gift ideas is healthy: it completed an MCP handshake in 2995 ms and exposes 9 tools.
Hand-picked gift ideas for kids' Christmas, turned into shareable wishlists fast.
Endpoint: https://santa-wish.vercel.app/api/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 9 |
| Latency | 2995 ms |
| Last checked (UTC) | 2026-10-25T17:50:31.715Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-25T17:50:31.715Z | Healthy | 2995 |
get_health | Health check for Santa Wishlist gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, 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 kids Christmas gifts on the user's marketplace. Returns PA-API products when configured for the default storefront, otherwise kids-filtered search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale for the end user. OpenAPI: searchAmazon. |
get_catalog | Paginated curated kids gift starters (~492). On amazon.se items include /dp/ASIN buy links; 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 an buyUrl (product /dp or kids search). ALWAYS pass marketplace + locale for the user. Does not invent Associates tags — uses server-configured tags per storefront. OpenAPI: resolveProduct. |
create_wishlist | Create a kids Christmas wishlist. Returns id, editToken, parentUrl, kidUrl, wishlist, storage. Save editToken for add_wishlist_item. If storage is token, later mutations may return a new id — always use the latest. OpenAPI: createWishlist. |
create_and_fill | One call: create a curated kids' Christmas gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, parentUrl, kidUrl. OpenAPI: agentCreateAndFill. |
get_wishlist | Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus parentUrl and kidUrl. 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. Token storage may return a new id — update bookmarks. OpenAPI: addWishlistItem. |