Housewarming Kit – hand-picked gift ideas

io.github.maggatPublished by GitHub account maggatv1.2.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that turns curated housewarming and first-apartment gift ideas into shareable Amazon wishlists with owner and shopper links.

What you can do
  • Check server health and list supported Amazon storefronts with currency hints and tracking-tag status
  • Search Amazon for housewarming and first-apartment essentials, or browse a paginated curated catalog of starter kits
  • Resolve an ASIN, a pasted product URL or keywords into a buy link for the chosen marketplace
  • Create a kit list, or create and fill one in a single call, returning an owner link and a shareable shop link
  • Fetch a kit by id and add items to it using an edit token
When to use it
Useful when someone wants gift ideas, a wishlist or a gift list for a housewarming, first apartment or moving-in occasion, especially on Amazon storefronts. It is aimed at quickly producing a shareable list rather than at general shopping or price comparison.
Requirements
A remote streamable HTTP endpoint; nothing to install locally. No authentication, environment variables or headers are declared. The assistant must pass a marketplace and locale on search, catalog and resolve calls, and an edit token from kit creation to add items.
Before you install
Creating kits writes data to the service and returns an edit token that must be kept to add items; the token storage may return a new id, so saved links can change. Product links may carry an affiliate tracking tag, and tagConfigured is false until real Associates IDs exist. Products are curated by the operator, not customer-reviewed, and searches and pasted URLs are sent to the service and onward to Amazon.

Installation

In SourceWeft

  1. Open Housewarming Kit – hand-picked gift ideas in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.maggat%2Fhousewarming-gifts/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "housewarming-kit-hand-picked-gift-ideas": {
      "type": "http",
      "url": "https://housewarming-kit.vercel.app/api/mcp"
    }
  }
}

Tools

9

get_health

Health & marketplaces

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.

Takes no parameters.

list_marketplaces

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

Takes no parameters.

search_kits

Search housewarming 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.

ParametersqrequiredlimitlocalerequiredmoveTyperoomFocusbudgetBandmarketplacerequired

get_catalog

Curated kit 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.

ParametersqlimitlocalerequiredoffsetmoveTyperoomFocusbudgetBandmarketplacerequired

resolve_product

Resolve buy / inspiration link

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.

ParametersurlasinlocalerequiredkeywordsmoveTyperoomFocusbudgetBandmarketplacerequired

create_kit

Create housewarming 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.

ParametersitemslocalerequiredcityHintmoveTyperoomFocusbudgetBandmarketplacerequiredhouseholdName

create_and_fill

One-shot 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.

ParameterslocalerequiredmoveTypeitemAsinsroomFocusbudgetBanditemQueriesmarketplacerequireditemKeywordshouseholdName

get_kit

Get kit

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

Parametersidrequired

add_kit_item

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.

ParametersidrequiredurlasinnameemojititlecatalogIdeditTokenrequiredsearchKeywords

Version history

1
  1. v1.2.0LatestOct 26, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.