Housewarming Kit – hand-picked gift ideas
Hand-picked gift ideas for housewarmings, turned into shareable wishlists fast.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"housewarming-gifts": {
"url": "https://housewarming-kit.vercel.app/api/mcp"
}
}
}リモートエンドポイント
https://housewarming-kit.vercel.app/api/mcpstreamable-httpできること
ツール一覧
ツール(9)
🟢get_health
Health 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.
入力スキーマ
{
"type": "object",
"properties": {}
}🟢list_marketplaces
List 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=).
入力スキーマ
{
"type": "object",
"properties": {}
}🟢search_kits(q, marketplace, locale, moveType, budgetBand, ...)
Search 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.
入力スキーマ
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. kitchen starter kit"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"moveType": {
"type": "string",
"description": "first-apartment | upgrade | couple-merge | student | furnished-rental"
},
"budgetBand": {
"type": "string"
},
"roomFocus": {
"type": "string",
"description": "kitchen | bathroom | sleep | laundry | cleaning | lighting | storage"
},
"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, moveType, budgetBand, ...)
Paginated 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.
入力スキーマ
{
"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."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"q": {
"type": "string"
},
"moveType": {
"type": "string"
},
"budgetBand": {
"type": "string"
},
"roomFocus": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0
}
},
"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 buyUrl (product /dp or apartment search). ALWAYS pass marketplace + locale. Does not invent Associates tags — trackingTag is null until configured. 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."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"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"
},
"moveType": {
"type": "string"
},
"budgetBand": {
"type": "string"
},
"roomFocus": {
"type": "string"
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_kit(marketplace, locale, householdName, moveType, budgetBand, ...)
Create 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.
入力スキーマ
{
"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."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"householdName": {
"type": "string"
},
"moveType": {
"type": "string"
},
"budgetBand": {
"type": "string"
},
"roomFocus": {
"type": "array",
"items": {
"type": "string"
}
},
"cityHint": {
"type": "string"
},
"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
}
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_and_fill(marketplace, locale, householdName, moveType, budgetBand, ...)
One 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: agentCreateAndFill.
入力スキーマ
{
"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."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"householdName": {
"type": "string"
},
"moveType": {
"type": "string"
},
"budgetBand": {
"type": "string"
},
"roomFocus": {
"type": "array",
"items": {
"type": "string"
}
},
"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 kit item"
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_kit(id)
Fetch a kit 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": "Kit id (short Redis id or t.* token)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_kit_item(id, editToken, name, title, asin, ...)
Add 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.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Kit 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#"
}コミュニティ
エビデンス