Housewarming Kit – hand-picked gift ideas

Working · 2.5 s

io.github.maggat/housewarming-giftsv1.2.0

Hand-picked gift ideas for housewarmings, turned into shareable wishlists fast.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://housewarming-kit.vercel.app/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_kit_item

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.

idstring, required

Kit id

editTokenstring, required

X-Edit-Token from create/mutate response

urlstring

asinstring

namestring

emojistring

titlestring

catalogIdstring

searchKeywordsstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

add_kit_item

Argument	Type	Description
id*	string	Kit id
url	string
asin	string
name	string
emoji	string
title	string
catalogId	string
editToken*	string	X-Edit-Token from create/mutate response
searchKeywords	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "editToken"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Kit id"
    },
    "url": {
      "type": "string"
    },
    "asin": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "emoji": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "catalogId": {
      "type": "string"
    },
    "editToken": {
      "type": "string",
      "minLength": 1,
      "description": "X-Edit-Token from create/mutate response"
    },
    "searchKeywords": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

create_and_fill

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.

Argument	Type	Description
locale*	string	User locale, e.g. en, sv, de, fr, es
moveType	string
itemAsins	array
roomFocus	array
budgetBand	string
itemQueries	array	Each query is searched and added as a kit item
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
itemKeywords	array
householdName	string

Input schema (JSON)

create_kit

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.

Argument	Type	Description
items	array
locale*	string	User locale, e.g. en, sv, de, fr, es
cityHint	string
moveType	string
roomFocus	array
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.
householdName	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "marketplace",
    "locale"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "asin": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "emoji": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "catalogId": {
            "type": "string"
          },
          "searchKeywords": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "cityHint": {
      "type": "string"
    },
    "moveType": {
      "type": "string"
    },
    "roomFocus": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "budgetBand": {
      "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."
    },
    "householdName": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_catalog

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.

read-only

Argument	Type	Description
q	string
limit	integer
locale*	string	User locale, e.g. en, sv, de, fr, es
offset	integer
moveType	string
roomFocus	string
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "marketplace",
    "locale"
  ],
  "properties": {
    "q": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 100,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "moveType": {
      "type": "string"
    },
    "roomFocus": {
      "type": "string"
    },
    "budgetBand": {
      "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."
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_kit

Fetch a kit by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.

read-only

Argument	Type	Description
id*	string	Kit id (short Redis id or t.* token)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Kit id (short Redis id or t.* token)"
    }
  },
  "additionalProperties": false
}

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=).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

resolve_product

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.

read-only

Argument	Type	Description
url	string	Pasted Amazon product URL
asin	string	10-char Amazon ASIN
locale*	string	User locale, e.g. en, sv, de, fr, es
keywords	string	Search keywords if no ASIN
moveType	string
roomFocus	string
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "marketplace",
    "locale"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Pasted Amazon product URL"
    },
    "asin": {
      "type": "string",
      "description": "10-char Amazon ASIN"
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "keywords": {
      "type": "string",
      "description": "Search keywords if no ASIN"
    },
    "moveType": {
      "type": "string"
    },
    "roomFocus": {
      "type": "string"
    },
    "budgetBand": {
      "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."
    }
  },
  "additionalProperties": false
}

search_kits

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.

read-only

Argument	Type	Description
q*	string	Search query, e.g. kitchen starter kit
limit	integer
locale*	string	User locale, e.g. en, sv, de, fr, es
moveType	string	first-apartment \| upgrade \| couple-merge \| student \| furnished-rental
roomFocus	string	kitchen \| bathroom \| sleep \| laundry \| cleaning \| lighting \| storage
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q",
    "marketplace",
    "locale"
  ],
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Search query, e.g. kitchen starter kit"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "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"
    },
    "roomFocus": {
      "type": "string",
      "description": "kitchen | bathroom | sleep | laundry | cleaning | lighting | storage"
    },
    "budgetBand": {
      "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."
    }
  },
  "additionalProperties": false
}