Girlfriend Gifts – hand-picked gift ideas

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

Hand-picked gift ideas for her (partner gifts), turned into shareable wishlists fast.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for finding romantic partner gift ideas on Amazon and turning them into shareable wishlists.

What you can do
  • Check server health and list supported Amazon storefronts with currency and locale hints
  • Search Amazon for romantic partner gifts, returning product data or search deep-link cards
  • Browse a curated catalog of 170+ gift ASINs and resolve an ASIN, pasted product URL or keywords to a buy link
  • Create a gift wishlist, or create and fill one in a single call with ASINs, keywords or search queries
  • Fetch a wishlist by id and add items to it using an edit token
When to use it
Useful when someone wants help brainstorming or shopping for a partner's gift and wants concrete Amazon product links or a shareable wishlist they can hand to another person.
Requirements
A remote streamable HTTP endpoint; no package install, account or API key is declared. Tools expect a marketplace and locale to be passed on most calls. Product data depends on the server's own Amazon PA-API configuration; without it, results fall back to search deep links.
Before you install
Wishlists are created and modified on the server, and the returned edit token grants further changes, so treat it as a secret. Buy links may carry the server operator's Amazon Associates tag, so purchases can credit that account. Wishlist storage may be token-based and return a new id after changes, so bookmarks can go stale.

Installation

In SourceWeft

  1. Open Girlfriend 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%2Fgirlfriend-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": {
    "girlfriend-gifts-hand-picked-gift-ideas": {
      "type": "http",
      "url": "https://girlfriendgifts.vercel.app/api/mcp"
    }
  }
}

Tools

9

get_health

Health & service info

Health check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.

Takes no parameters.

list_marketplaces

List Amazon marketplaces

List supported Amazon storefronts (id, domain, label, defaultLocale, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.

Takes no parameters.

search_gifts

Search girlfriend / wife gifts

Search Amazon for romantic partner gifts to build a recommendation or shopping list. Returns PA-API products when configured for the default storefront, otherwise romantic search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.

ParametersqrequiredlimitlocalerequiredoccasionstyleTagbudgetBandmarketplacerequired

get_catalog

Curated gift catalog

Curated girlfriend/wife gift catalog (170+ real amazon.se /dp ASINs) for building shopping lists and wishlists. On amazon.se items include /dp/ASIN buy links (tag sw-girlfriend-21 when configured); on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatalog.

ParametersqlocalerequiredoccasionstyleTagstyleTagsbudgetBandmarketplacerequired

resolve_product

Resolve buy / inspiration link

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or romantic search). ALWAYS pass marketplace + locale for the user. Does not invent Associates tags — uses server-configured tags per storefront. OpenAPI: resolveProduct.

ParametersurlasinlocalerequiredkeywordsoccasionstyleTagbudgetBandmarketplacerequired

create_wishlist

Create wishlist

Create a girlfriend/wife gift list / wishlist for shopping-list building. Returns id, editToken, ownerUrl (she edits), shopUrl (he/agent shops), 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.

ParametersitemslocaleoccasionstyleTagsbudgetBandmarketplacerelationshiprecipientName

create_and_fill

One-shot create and fill

Preferred agent path for list-building: create a gift wishlist and fill it with ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. Pass marketplace + locale. OpenAPI: agentCreateAndFill.

ParameterslocaleoccasionitemAsinsstyleTagsbudgetBanditemQueriesmarketplaceitemKeywordsrelationshiprecipientName

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 gift list / wishlist (shopping-list building). Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. Prefer buyUrl in responses. OpenAPI: addWishlistItem.

ParametersidrequiredurlasinnameemojititlelocalecatalogIdeditTokenrequiredmarketplacesearchKeywords

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.