Wedding Gift Board – hand-picked gift ideas

Working · 3.1 s

io.github.maggat/wedding-giftsv1.2.0

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

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

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

https://wedding-gift-board.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_item

Add an item to a wedding gift board. Requires editToken from create.

idstring, required

Board 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 (8)

add_item

Add an item to a wedding gift board. Requires editToken from create.

Argument	Type	Description
id*	string	Board 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": "Board 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
}

browse_catalog

Curated, live-verified wedding gift products for a storefront: amazon.se (Sweden) or amazon.com (United States). Each item has a /dp buyUrl, price and image. Optional q / occasion / budgetBand / styleTag filters.

read-only

Argument	Type	Description
q	string
limit	integer
occasion	string
styleTag	string
budgetBand	string
marketplace	string	Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 60,
      "minimum": 1
    },
    "occasion": {
      "enum": [
        "wedding",
        "engagement",
        "honeymoon",
        "anniversary",
        "housewarming",
        "other"
      ],
      "type": "string"
    },
    "styleTag": {
      "enum": [
        "practical",
        "luxury",
        "experience",
        "jewelry",
        "home",
        "fashion",
        "tech",
        "personalized",
        "beauty",
        "romantic"
      ],
      "type": "string"
    },
    "budgetBand": {
      "enum": [
        "under-300",
        "300-700",
        "700-1500",
        "1500-plus"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se."
    }
  },
  "additionalProperties": false
}

create_and_fill

One call: create a curated wedding gift wishlist and return shopUrl (share link) + ownerUrl. One-shot: create a wedding gift board and fill from ASINs/keywords/queries. Pass marketplace (amazon.com for US users, amazon.se for Sweden) + locale; optional, defaults as described.

Argument	Type	Description
locale	string	User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted.
occasion	string
itemAsins	array
styleTags	array
budgetBand	string
coupleNames	string
itemQueries	array
marketplace	string	Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se.
weddingDate	string

create_wishlist

Create a couple wedding gift board. Returns id, editToken, coupleUrl, guestUrl. Pass marketplace (amazon.com for US users, amazon.se for Sweden) + locale; optional, defaults as described.

Argument	Type	Description
items	array
locale	string	User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted.
occasion	string
styleTags	array
budgetBand	string
coupleNames	string	e.g. "Alex & Sam" (alias: recipientName)
marketplace	string	Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se.
weddingDate	string
recipientName	string	Deprecated alias for coupleNames

Input schema (JSON)

health

Health check for Wedding Gift Board. Returns ok, storage, paapi, tagConfigured, linkMode, catalogCount (amazon.se) / catalogCounts (amazon.se + amazon.com), marketplaces.

read-only

No arguments.

Input schema (JSON)

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

list_marketplaces

List supported Amazon storefronts. Pick the user's marketplace and pass it on search/resolve/create (amazon.com for US, en-US). Curated catalogs: amazon.se and amazon.com.

read-only

No arguments.

Input schema (JSON)

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

resolve_product

Resolve ASIN, Amazon /dp URL, or keywords to a marketplace URL. Pass marketplace + locale (amazon.com + en for United States users; amazon.se + sv for Sweden). Both optional — omitted means en-US Accept-Language → amazon.com, else amazon.se.

read-only

Argument	Type	Description
url	string	Pasted Amazon product URL
asin	string	10-char Amazon ASIN
locale	string	User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted.
keywords	string	Search keywords if no ASIN
occasion	string
styleTag	string
marketplace	string	Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "url": {
      "type": "string",
      "description": "Pasted Amazon product URL"
    },
    "asin": {
      "type": "string",
      "description": "10-char Amazon ASIN"
    },
    "locale": {
      "type": "string",
      "description": "User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted."
    },
    "keywords": {
      "type": "string",
      "description": "Search keywords if no ASIN"
    },
    "occasion": {
      "enum": [
        "wedding",
        "engagement",
        "honeymoon",
        "anniversary",
        "housewarming",
        "other"
      ],
      "type": "string"
    },
    "styleTag": {
      "enum": [
        "practical",
        "luxury",
        "experience",
        "jewelry",
        "home",
        "fashion",
        "tech",
        "personalized",
        "beauty",
        "romantic"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se."
    }
  },
  "additionalProperties": false
}

search_gifts

Search Amazon for wedding / registry gifts on the user's marketplace. Pass marketplace + locale (amazon.com + en for United States users; amazon.se + sv for Sweden). Both optional — omitted means en-US Accept-Language → amazon.com, else amazon.se.

read-only

Argument	Type	Description
q*	string	Search query, e.g. linen duvet set
limit	integer
locale	string	User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted.
occasion	string
styleTag	string
budgetBand	string
marketplace	string	Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Search query, e.g. linen duvet set"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "description": "User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted."
    },
    "occasion": {
      "enum": [
        "wedding",
        "engagement",
        "honeymoon",
        "anniversary",
        "housewarming",
        "other"
      ],
      "type": "string"
    },
    "styleTag": {
      "enum": [
        "practical",
        "luxury",
        "experience",
        "jewelry",
        "home",
        "fashion",
        "tech",
        "personalized",
        "beauty",
        "romantic"
      ],
      "type": "string"
    },
    "budgetBand": {
      "enum": [
        "under-300",
        "300-700",
        "700-1500",
        "1500-plus"
      ],
      "type": "string"
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se."
    }
  },
  "additionalProperties": false
}

{ "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", "description": "User locale, e.g. en (US), sv (Sweden). Optional — derived from the storefront when omitted." }, "occasion": { "enum": [ "wedding", "engagement", "honeymoon", "anniversary", "housewarming", "other" ], "type": "string" }, "styleTags": { "type": "array", "items": { "enum": [ "practical", "luxury", "experience", "jewelry", "home", "fashion", "tech", "personalized", "beauty", "romantic" ], "type": "string" } }, "budgetBand": { "enum": [ "under-300", "300-700", "700-1500", "1500-plus" ], "type": "string" }, "coupleNames": { "type": "string", "description": "e.g. \"Alex & Sam\" (alias: recipientName)" }, "marketplace": { "type": "string", "description": "Amazon storefront for the end user: amazon.com (or us) for United States users — curated amazon.com/dp links in USD, English; amazon.se (or se) for Sweden. Optional: when omitted, an en-US Accept-Language selects amazon.com, otherwise amazon.se." }, "weddingDate": { "type": "string" }, "recipientName": { "type": "string", "description": "Deprecated alias for coupleNames" } }, "additionalProperties": false }