Host Gifts – hand-picked gift ideas

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

Hand-picked gift ideas for dinner hosts that assistants turn into shareable wishlists fast. SE + US.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search curated Amazon host/hostess gift ideas and turn them into shareable wishlists with owner and shopper links.

What you can do
  • Check server health and list supported Amazon marketplaces
  • Search Amazon for hostess and dinner-party gifts, or browse a paginated curated gift catalog
  • Resolve an ASIN, pasted Amazon product URL or keywords into a buy link
  • Create a gift wishlist, add items to it, and fetch it by id
  • Create and fill a curated wishlist in one call and return a share link
When to use it
Useful when someone wants host or hostess gift ideas, a dinner-party present list, or a quick shareable wishlist for a Swedish or US Amazon storefront. It is a narrow, gift-specific helper rather than a general shopping tool.
Requirements
Remote endpoint, no installation or credentials declared. The assistant should pass a marketplace and locale on search, catalog and resolve calls, and keep the editToken returned by wishlist creation to add items later.
Before you install
Wishlists are created on a third-party service and shareable links expose their contents; the editToken returned at creation is needed to modify a wishlist, so treat it as a secret. Products are curated by the operator, not customer-reviewed, and buy links may carry a tracking tag once enrolled.

Installation

In SourceWeft

  1. Open Host Gifts – 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%2Fhost-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": {
    "host-gifts-hand-picked-gift-ideas": {
      "type": "http",
      "url": "https://host-gifts.vercel.app/api/mcp"
    }
  }
}

Tools

9

get_health

Health & marketplaces

Health check for Host Gifts. Returns ok, storage, paapi, trackingTag (null until enrolled), defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use this first. OpenAPI: getHealth.

Takes no parameters.

list_marketplaces

List Amazon marketplaces

List supported Amazon storefronts. Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.

Takes no parameters.

search_gifts

Search host gifts

Search Amazon for hostess / dinner-party gifts on the user's marketplace. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.

ParametersqrequiredlimitlocalerequiredoccasionmarketplacerequireddietaryNotesgiftCategory

get_catalog

Curated gift catalog

Paginated curated host gift starters. ALWAYS pass marketplace + locale. Search remains primary discovery. OpenAPI: getCatalog.

ParametersqlimitlocalerequiredoffsetoccasionmarketplacerequiredgiftCategorygiftCategories

resolve_product

Resolve buy link

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (trackingTag null until enrolled). ALWAYS pass marketplace + locale. OpenAPI: resolveProduct.

ParametersurlasinlocalerequiredkeywordsoccasionbudgetBandmarketplacerequiredgiftCategory

create_wishlist

Create wishlist

Create a host gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.

ParametersitemslocalehostNameoccasionbudgetBandmarketplacedietaryNotesgiftCategories

create_and_fill

One-shot create and fill

One call: create a curated host / hostess gifts gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. OpenAPI: agentCreateAndFill.

ParameterslocalehostNameoccasionitemAsinsbudgetBanditemQueriesmarketplacedietaryNotesitemKeywordsgiftCategories

get_wishlist

Get wishlist

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

Parametersidrequired

add_wishlist_item

Add wish item

Add an item to a wishlist. Requires editToken from create. 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.