Girlfriend Gifts – hand-picked gift ideas

Working · 2.4 s

io.github.maggat/girlfriend-giftsv1.2.0

Hand-picked gift ideas for her (partner gifts), 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://girlfriendgifts.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_wishlist_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.

idstring, required

Wishlist id

editTokenstring, required

X-Edit-Token from create/mutate response

urlstring

asinstring

namestring

emojistring

titlestring

localestring

User locale, e.g. en, sv, de, fr, es

catalogIdstring

marketplacestring

Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.

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_wishlist_item

Argument	Type	Description
id*	string	Wishlist id
url	string
asin	string
name	string
emoji	string
title	string
locale	string	User locale, e.g. en, sv, de, fr, es
catalogId	string
editToken*	string	X-Edit-Token from create/mutate response
marketplace	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.
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": "Wishlist id"
    },
    "url": {
      "type": "string"
    },
    "asin": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "emoji": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "catalogId": {
      "type": "string"
    },
    "editToken": {
      "type": "string",
      "minLength": 1,
      "description": "X-Edit-Token from create/mutate response"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links."
    },
    "searchKeywords": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
locale	string	User locale, e.g. en, sv, de, fr, es
occasion	string
itemAsins	array
styleTags	array
budgetBand	string
itemQueries	array	Each query is searched and added as a wish
marketplace	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.
itemKeywords	array
relationship	string
recipientName	string

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.

Argument	Type	Description
items	array
locale	string	User locale, e.g. en, sv, de, fr, es
occasion	string
styleTags	array
budgetBand	string
marketplace	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.
relationship	string
recipientName	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "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"
    },
    "occasion": {
      "enum": [
        "anniversary",
        "birthday",
        "valentines",
        "just-because",
        "apology",
        "wedding",
        "other"
      ],
      "type": "string"
    },
    "styleTags": {
      "type": "array",
      "items": {
        "enum": [
          "romantic",
          "practical",
          "luxury",
          "experience",
          "jewelry",
          "beauty",
          "home",
          "fashion",
          "tech",
          "personalized"
        ],
        "type": "string"
      }
    },
    "budgetBand": {
      "enum": [
        "under-300",
        "300-700",
        "700-1500",
        "1500-plus"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links."
    },
    "relationship": {
      "enum": [
        "girlfriend",
        "wife",
        "fiancée",
        "partner"
      ],
      "type": "string"
    },
    "recipientName": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_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.

read-only

Argument	Type	Description
q	string	Full-text filter
locale*	string	User locale, e.g. en, sv, de, fr, es
occasion	string
styleTag	string
styleTags	string	Comma-separated style tags
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "marketplace",
    "locale"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Full-text filter"
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "occasion": {
      "enum": [
        "anniversary",
        "birthday",
        "valentines",
        "just-because",
        "apology",
        "wedding",
        "other"
      ],
      "type": "string"
    },
    "styleTag": {
      "enum": [
        "romantic",
        "practical",
        "luxury",
        "experience",
        "jewelry",
        "beauty",
        "home",
        "fashion",
        "tech",
        "personalized"
      ],
      "type": "string"
    },
    "styleTags": {
      "type": "string",
      "description": "Comma-separated style tags"
    },
    "budgetBand": {
      "enum": [
        "under-300",
        "300-700",
        "700-1500",
        "1500-plus"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links."
    }
  },
  "additionalProperties": false
}

get_health

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

read-only

No arguments.

Input schema (JSON)

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

get_wishlist

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

read-only

Argument	Type	Description
id*	string	Wishlist 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": "Wishlist id (short Redis id or t.* token)"
    }
  },
  "additionalProperties": false
}

list_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.

read-only

No arguments.

Input schema (JSON)

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

resolve_product

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.

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
occasion	string
styleTag	string
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.

Input schema (JSON)

search_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.

read-only

Argument	Type	Description
q*	string	Search query, e.g. pearl earrings
limit	integer
locale*	string	User locale, e.g. en, sv, de, fr, es
occasion	string
styleTag	string	Style / category filter
budgetBand	string
marketplace*	string	Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links.

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. pearl earrings"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "description": "User locale, e.g. en, sv, de, fr, es"
    },
    "occasion": {
      "enum": [
        "anniversary",
        "birthday",
        "valentines",
        "just-because",
        "apology",
        "wedding",
        "other"
      ],
      "type": "string"
    },
    "styleTag": {
      "enum": [
        "romantic",
        "practical",
        "luxury",
        "experience",
        "jewelry",
        "beauty",
        "home",
        "fashion",
        "tech",
        "personalized"
      ],
      "type": "string",
      "description": "Style / category filter"
    },
    "budgetBand": {
      "enum": [
        "under-300",
        "300-700",
        "700-1500",
        "1500-plus"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "minLength": 2,
      "description": "Amazon storefront domain or id for the end user, e.g. amazon.com, amazon.se, us, se, de. REQUIRED — catalog has 100+ real /dp ASINs on amazon.se; other marketplaces get romantic search deep-links."
    }
  },
  "additionalProperties": false
}