Mother's Day Gifts MCP
A remote MCP server that allows AI assistants to build curated Mother's Day gift wishlists and gift lists. It supports creating shareable links for shoppers in Sweden (amazon.se) and the United States (amazon.com), handling marketplace selection based on locale and providing curated product picks with tracking tags.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mothers-day-gifts.vercel.app/api/mcpWhat you can do with it
- Create a Mother's Day gift wishlist for a specific recipient and budget
- Generate a shareable shopping list link for gift-givers
- Search for curated gift ideas based on style tags like wellness
- Resolve product URLs for Amazon.se or Amazon.com marketplaces
Source and maintenance
Protocol and capabilities
- Server
- mothers-day-gifts 1.1.0
- MCP protocol
- 2025-06-18
- Tools
- 10 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
get_health — Health & marketplaces
Health check for Mother's Day Gifts. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount. Use this first to discover service status. OpenAPI: getHealth.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}list_marketplaces — List Amazon marketplaces
List supported Amazon storefronts via GET /api/v1/marketplaces (domain, label, tagConfigured). Pick the user's store and pass it as marketplace (amazon.com for US shoppers, amazon.se for Sweden).
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}search_gifts — Search Mother's Day gifts
Search Amazon for Mother's Day / Mors dag gift ideas on the user's marketplace. Returns PA-API products when configured for the default storefront, otherwise Mother's Day search deep-link cards + catalogMatches. Pass marketplace + locale for the end user (marketplace=amazon.com for US/English, amazon.se for Sweden; if omitted, Accept-Language en-US → amazon.com, else amazon.se). OpenAPI: searchAmazon.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. spa set, 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 (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"interest": {
"$ref": "#/properties/styleTag",
"description": "Alias for styleTag"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"styleTag": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string",
"description": "Style / interest filter"
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}suggest_gifts — Suggest Mother's Day gifts
Alias of search_gifts — suggest Mother's Day gift ideas for a query on the user's marketplace. Pass marketplace + locale (marketplace=amazon.com for US/English, amazon.se for Sweden; if omitted, Accept-Language en-US → amazon.com, else amazon.se).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search / suggest query"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"styleTag": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string"
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}get_catalog — Curated Mother's Day catalog
Paginated curated Mother's Day gift starters. On amazon.se (SE catalog) and amazon.com (US catalog) items include /dp/ASIN links; on other marketplaces catalogMode is search-ideas. Pass marketplace + locale (marketplace=amazon.com for US/English, amazon.se for Sweden; if omitted, Accept-Language en-US → amazon.com, else amazon.se). Search (search_gifts) remains primary discovery. OpenAPI: getCatalog.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Full-text filter"
},
"ids": {
"type": "string",
"description": "Comma-separated catalog ids"
},
"limit": {
"type": "integer",
"default": 24,
"maximum": 100,
"minimum": 1
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"interest": {
"$ref": "#/properties/styleTag"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"styleTag": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string"
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}resolve_product — Resolve buy link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or Mother's Day search). Pass marketplace + locale (marketplace=amazon.com for US/English, amazon.se for Sweden; if omitted, Accept-Language en-US → amazon.com, else amazon.se). OpenAPI: resolveProduct.
{
"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",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"styleTag": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string"
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
},
"preferSearch": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}create_wishlist — Create Mother's Day gift list
Create a Mother's Day gift wishlist. Returns id, editToken, ownerUrl, shopUrl, 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.
{
"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 (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"styleTags": {
"type": "array",
"items": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string"
}
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
},
"relationship": {
"type": "string",
"description": "mom | stepmom | mother-in-law | grandma | other"
},
"recipientName": {
"type": "string",
"description": "Mom / recipient display name"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}create_and_fill — One-shot create and fill
One call: create a curated Mother's Day (Mors dag) gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a Mother's Day wishlist and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. OpenAPI: agentCreateAndFill.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es (mothers day / mors dag / Muttertag / fête des mères / día de la madre)"
},
"occasion": {
"enum": [
"mothers-day",
"birthday",
"just-because",
"other"
],
"type": "string"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"styleTags": {
"type": "array",
"items": {
"enum": [
"wellness",
"jewelry",
"home",
"beauty",
"practical",
"personalized",
"luxury",
"tech",
"plants",
"experience"
],
"type": "string"
}
},
"budgetBand": {
"enum": [
"under-300",
"300-700",
"700-1500",
"1500-plus"
],
"type": "string"
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Each query is searched and added as a wish"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront for the end user, e.g. amazon.se, amazon.com, us, se, de. Recommended: pass marketplace=amazon.com for US shoppers (US catalog, English, USD, tag sw-mothersday-20) and amazon.se for Sweden (SE catalog, tag sw-mothersday-21). If omitted: Accept-Language en-US → amazon.com, otherwise amazon.se. Other storefronts get Mother's Day search links."
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"relationship": {
"type": "string"
},
"recipientName": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}get_wishlist — Get gift list
Fetch a Mother's Day wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
{
"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
}{
"readOnlyHint": true,
"openWorldHint": true
}add_wishlist_item — Add gift list item
Add an item to a Mother's Day wishlist. 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.
{
"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"
},
"catalogId": {
"type": "string"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "X-Edit-Token from create/mutate response"
},
"searchKeywords": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 553 ms
- 95th percentile latency
- 553 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 553 ms · metadata changed · 10 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http mother-s-day-gifts-mcp https://mothers-day-gifts.vercel.app/api/mcpCodex
codex mcp add mother-s-day-gifts-mcp --url https://mothers-day-gifts.vercel.app/api/mcpCursor
{
"mcpServers": {
"mother-s-day-gifts-mcp": {
"url": "https://mothers-day-gifts.vercel.app/api/mcp"
}
}
}Cline
{
"mcpServers": {
"mother-s-day-gifts-mcp": {
"type": "streamableHttp",
"url": "https://mothers-day-gifts.vercel.app/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"mother-s-day-gifts-mcp": {
"type": "http",
"url": "https://mothers-day-gifts.vercel.app/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http mother-s-day-gifts-mcp https://mothers-day-gifts.vercel.app/api/mcpClaude Desktop
{
"mcpServers": {
"mother-s-day-gifts-mcp": {
"url": "https://mothers-day-gifts.vercel.app/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"mother-s-day-gifts-mcp": {
"serverUrl": "https://mothers-day-gifts.vercel.app/api/mcp"
}
}
}Let your agent find its tools
Find servers like Mother's Day Gifts MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.