Mother's Day Gifts – hand-picked gift ideas
Hand-picked gift ideas for Mother's Day that assistants turn into shareable wishlists fast. SE + US.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"mothers-gifts": {
"url": "https://mothers-day-gifts.vercel.app/api/mcp"
}
}
}远程端点
https://mothers-day-gifts.vercel.app/api/mcpstreamable-http它能做什么
工具清单
工具（10）
🟢get_health
Health check for Mother's Day Gifts. Returns ok, storage, paapi, trackingTag (null until real Associates IDs), defaultDomain, catalogCount. Use this first to discover service status. OpenAPI: getHealth.
输入模式
{
"type": "object",
"properties": {}
}🟢list_marketplaces
List supported Amazon storefronts via GET /api/v1/marketplaces (domain, label, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
输入模式
{
"type": "object",
"properties": {}
}🟢search_gifts(q, marketplace, locale, occasion, budgetBand, ...)
Search Amazon for Mother's Day / Mors dag gift ideas on the user's marketplace. Returns PA-API products when configured for the default storefront, otherwise Mother's Day search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale for the end user. OpenAPI: searchAmazon.
输入模式
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. spa set, pearl earrings"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"styleTag": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"description": "Style / interest filter"
},
"interest": {
"$ref": "#/properties/styleTag",
"description": "Alias for styleTag"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"required": [
"q",
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢suggest_gifts(q, marketplace, locale, occasion, budgetBand, ...)
Alias of search_gifts — suggest Mother's Day gift ideas for a query on the user's marketplace. ALWAYS pass marketplace + locale.
输入模式
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search / suggest query"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"styleTag": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"required": [
"q",
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_catalog(marketplace, locale, q, occasion, budgetBand, ...)
Paginated curated Mother's Day gift starters. On amazon.se items may include /dp/ASIN links when ASINs exist; on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. Search (search_gifts) remains primary discovery. OpenAPI: getCatalog.
输入模式
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"q": {
"type": "string",
"description": "Full-text filter"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"styleTag": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
]
},
"interest": {
"$ref": "#/properties/styleTag"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0
},
"ids": {
"type": "string",
"description": "Comma-separated catalog ids"
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_product(marketplace, locale, asin, url, keywords, ...)
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or Mother's Day search). ALWAYS pass marketplace + locale. Does not invent Associates tags — omits tag= until server-configured real IDs. OpenAPI: resolveProduct.
输入模式
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"asin": {
"type": "string",
"description": "10-char Amazon ASIN"
},
"url": {
"type": "string",
"description": "Pasted Amazon product URL"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"styleTag": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"preferSearch": {
"type": "boolean"
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_wishlist(recipientName, occasion, budgetBand, styleTags, relationship, ...)
Create a Mother's Day gift wishlist. Returns id, editToken, ownerUrl, shopUrl, 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.
输入模式
{
"type": "object",
"properties": {
"recipientName": {
"type": "string",
"description": "Mom / recipient display name"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"styleTags": {
"type": "array",
"items": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
]
}
},
"relationship": {
"type": "string",
"description": "mom | stepmom | mother-in-law | grandma | other"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_and_fill(recipientName, occasion, budgetBand, styleTags, relationship, ...)
One call: create a curated Mother's Day (Mors dag) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a Mother's Day wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. OpenAPI: agentCreateAndFill.
输入模式
{
"type": "object",
"properties": {
"recipientName": {
"type": "string"
},
"occasion": {
"type": "string",
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
]
},
"styleTags": {
"type": "array",
"items": {
"type": "string",
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
]
}
},
"relationship": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED — curated ASINs only produce /dp links on amazon.se; other marketplaces get Mother's Day search deep-links."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Each query is searched and added as a wish"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_wishlist(id)
Fetch a Mother's Day wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id (short Redis id or t.* token)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_wishlist_item(id, editToken, name, title, asin, ...)
Add an item to a Mother's Day 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.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "X-Edit-Token from create/mutate response"
},
"name": {
"type": "string"
},
"title": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"required": [
"id",
"editToken"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社区
证据