Teacher Gifts – hand-picked gift ideas
Hand-picked gift ideas for teachers that assistants turn into shareable wishlists fast. SE + US.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"teacher-gifts": {
"url": "https://teacher-presents.vercel.app/api/mcp"
}
}
}Remote-Endpunkte
https://teacher-presents.vercel.app/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (9)
🟢get_health
Health check for Teacher presents. Returns ok, storage, paapi, trackingTag (null until enrolled), defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use this first. OpenAPI: getHealth.
Eingabe-Schema
{
"type": "object",
"properties": {}
}🟢list_marketplaces
List supported Amazon storefronts. Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
Eingabe-Schema
{
"type": "object",
"properties": {}
}🟢search_gifts(q, marketplace, locale, occasion, giftCategory, ...)
Search Amazon for teacher appreciation gifts on the user's marketplace. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
Eingabe-Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. cheese board"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"occasion": {
"type": "string",
"enum": [
"end-of-year",
"teachers-day",
"thank-you",
"christmas",
"graduation",
"first-day",
"birthday",
"just-because",
"other"
]
},
"giftCategory": {
"type": "string",
"enum": [
"stationery",
"mug",
"plant",
"spa",
"book",
"tech",
"classroom",
"personalized",
"chocolate",
"candle",
"tote",
"jewelry",
"home",
"practical",
"luxury"
]
},
"subject": {
"type": "string",
"description": "Optional subject / class"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"required": [
"q",
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_catalog(marketplace, locale, q, occasion, giftCategory, ...)
Paginated curated teacher gift starters. ALWAYS pass marketplace + locale. Search remains primary discovery. OpenAPI: getCatalog.
Eingabe-Schema
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"q": {
"type": "string",
"description": "Full-text filter"
},
"occasion": {
"type": "string",
"enum": [
"end-of-year",
"teachers-day",
"thank-you",
"christmas",
"graduation",
"first-day",
"birthday",
"just-because",
"other"
]
},
"giftCategory": {
"type": "string",
"enum": [
"stationery",
"mug",
"plant",
"spa",
"book",
"tech",
"classroom",
"personalized",
"chocolate",
"candle",
"tote",
"jewelry",
"home",
"practical",
"luxury"
]
},
"giftCategories": {
"type": "string",
"description": "Comma-separated gift categories"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_product(marketplace, locale, asin, url, keywords, ...)
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (trackingTag null until enrolled). ALWAYS pass marketplace + locale. OpenAPI: resolveProduct.
Eingabe-Schema
{
"type": "object",
"properties": {
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"asin": {
"type": "string",
"description": "10-char Amazon ASIN"
},
"url": {
"type": "string",
"description": "Pasted Amazon product URL"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"occasion": {
"type": "string",
"enum": [
"end-of-year",
"teachers-day",
"thank-you",
"christmas",
"graduation",
"first-day",
"birthday",
"just-because",
"other"
]
},
"giftCategory": {
"type": "string",
"enum": [
"stationery",
"mug",
"plant",
"spa",
"book",
"tech",
"classroom",
"personalized",
"chocolate",
"candle",
"tote",
"jewelry",
"home",
"practical",
"luxury"
]
},
"budgetBand": {
"type": "string"
}
},
"required": [
"marketplace",
"locale"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_wishlist(teacherName, occasion, budgetBand, giftCategories, subject, ...)
Create a teacher gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.
Eingabe-Schema
{
"type": "object",
"properties": {
"teacherName": {
"type": "string"
},
"occasion": {
"type": "string",
"enum": [
"end-of-year",
"teachers-day",
"thank-you",
"christmas",
"graduation",
"first-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string"
},
"giftCategories": {
"type": "array",
"items": {
"type": "string",
"enum": [
"stationery",
"mug",
"plant",
"spa",
"book",
"tech",
"classroom",
"personalized",
"chocolate",
"candle",
"tote",
"jewelry",
"home",
"practical",
"luxury"
]
}
},
"subject": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_and_fill(teacherName, occasion, budgetBand, giftCategories, subject, ...)
One call: create a curated teacher 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"teacherName": {
"type": "string"
},
"occasion": {
"type": "string",
"enum": [
"end-of-year",
"teachers-day",
"thank-you",
"christmas",
"graduation",
"first-day",
"birthday",
"just-because",
"other"
]
},
"budgetBand": {
"type": "string"
},
"giftCategories": {
"type": "array",
"items": {
"type": "string",
"enum": [
"stationery",
"mug",
"plant",
"spa",
"book",
"tech",
"classroom",
"personalized",
"chocolate",
"candle",
"tote",
"jewelry",
"home",
"practical",
"luxury"
]
}
},
"subject": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 2,
"description": "Amazon storefront domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Each query is searched and added as a wish"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_wishlist(id)
Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_wishlist_item(id, editToken, name, title, asin, ...)
Add an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist id"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "X-Edit-Token from create/mutate response"
},
"name": {
"type": "string"
},
"title": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"required": [
"id",
"editToken"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis