Studenten Gifts MCP
A remote MCP server that allows AI agents to build shareable gift wishlists for Swedish high-school graduations (studenten). It curates Amazon.se products, generates owner and shopper links, and supports budget-based filtering and category selection in a single API call.
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://studenten-gifts.vercel.app/api/mcpWhat you can do with it
- Build a graduation gift wishlist for a specific person
- Generate a shareable link for gift-givers
- Search curated gift ideas by budget and category
- Resolve product ASINs to Amazon.se buy links
Source and maintenance
Protocol and capabilities
- Server
- studenten-gifts 1.1.0
- MCP protocol
- 2025-06-18
- Tools
- 9 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
9 advertised
get_health — Health & marketplaces
Health check for Studenten Gifts. Returns ok, storage, paapi, trackingTag (null until enrolled), defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use this first. OpenAPI: getHealth.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}list_marketplaces — List Amazon marketplaces
List supported Amazon storefronts. Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}search_gifts — Search Studenten gifts
Search Amazon for Studenten / studentexamen gifts on the user's marketplace. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
{
"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. cheese board"
},
"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": [
"studentexamen",
"mottagning",
"studentflak",
"graduation-dinner",
"thank-you-student",
"white-cap-party",
"afterparty",
"other"
],
"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."
},
"giftCategory": {
"enum": [
"jewelry",
"flowers",
"fashion",
"tech",
"experience",
"keepsakes",
"party",
"gourmet",
"champagne-accessories",
"photo",
"practical",
"luxury"
],
"type": "string"
},
"relationship": {
"enum": [
"parent",
"friend",
"relative",
"partner"
],
"type": "string",
"description": "Giver relationship: parent|friend|relative|partner"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}get_catalog — Curated gift catalog
Paginated curated student gift starters. ALWAYS pass marketplace + locale. Search remains primary discovery. OpenAPI: getCatalog.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"marketplace",
"locale"
],
"properties": {
"q": {
"type": "string",
"description": "Full-text filter"
},
"limit": {
"type": "integer",
"default": 24,
"maximum": 100,
"minimum": 1
},
"locale": {
"type": "string",
"minLength": 2,
"description": "User locale, e.g. en, sv, de, fr, es"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"occasion": {
"enum": [
"studentexamen",
"mottagning",
"studentflak",
"graduation-dinner",
"thank-you-student",
"white-cap-party",
"afterparty",
"other"
],
"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."
},
"giftCategory": {
"enum": [
"jewelry",
"flowers",
"fashion",
"tech",
"experience",
"keepsakes",
"party",
"gourmet",
"champagne-accessories",
"photo",
"practical",
"luxury"
],
"type": "string"
},
"giftCategories": {
"type": "string",
"description": "Comma-separated gift categories"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}resolve_product — Resolve buy link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (trackingTag null until enrolled). ALWAYS pass marketplace + locale. OpenAPI: resolveProduct.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"marketplace",
"locale"
],
"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"
},
"keywords": {
"type": "string",
"description": "Search keywords if no ASIN"
},
"occasion": {
"enum": [
"studentexamen",
"mottagning",
"studentflak",
"graduation-dinner",
"thank-you-student",
"white-cap-party",
"afterparty",
"other"
],
"type": "string"
},
"budgetBand": {
"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."
},
"giftCategory": {
"enum": [
"jewelry",
"flowers",
"fashion",
"tech",
"experience",
"keepsakes",
"party",
"gourmet",
"champagne-accessories",
"photo",
"practical",
"luxury"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}create_wishlist — Create wishlist
Create a student gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. 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"
},
"occasion": {
"enum": [
"studentexamen",
"mottagning",
"studentflak",
"graduation-dinner",
"thank-you-student",
"white-cap-party",
"afterparty",
"other"
],
"type": "string"
},
"budgetBand": {
"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."
},
"studentName": {
"type": "string"
},
"relationship": {
"enum": [
"parent",
"friend",
"relative",
"partner"
],
"type": "string"
},
"giftCategories": {
"type": "array",
"items": {
"enum": [
"jewelry",
"flowers",
"fashion",
"tech",
"experience",
"keepsakes",
"party",
"gourmet",
"champagne-accessories",
"photo",
"practical",
"luxury"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}create_and_fill — One-shot create and fill
One call: create a curated Swedish high-school graduation (studenten) 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.
{
"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"
},
"occasion": {
"enum": [
"studentexamen",
"mottagning",
"studentflak",
"graduation-dinner",
"thank-you-student",
"white-cap-party",
"afterparty",
"other"
],
"type": "string"
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"budgetBand": {
"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 domain or id for the end user, e.g. amazon.se, amazon.com, se, de. REQUIRED."
},
"studentName": {
"type": "string"
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"relationship": {
"enum": [
"parent",
"friend",
"relative",
"partner"
],
"type": "string"
},
"giftCategories": {
"type": "array",
"items": {
"enum": [
"jewelry",
"flowers",
"fashion",
"tech",
"experience",
"keepsakes",
"party",
"gourmet",
"champagne-accessories",
"photo",
"practical",
"luxury"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true
}get_wishlist — Get wishlist
Fetch a 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"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true
}add_wishlist_item — Add wish item
Add an item to a wishlist. Requires editToken from create. 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
- 1284 ms
- 95th percentile latency
- 1284 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1284 ms · metadata changed · 9 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http studenten-gifts-mcp https://studenten-gifts.vercel.app/api/mcpCodex
codex mcp add studenten-gifts-mcp --url https://studenten-gifts.vercel.app/api/mcpCursor
{
"mcpServers": {
"studenten-gifts-mcp": {
"url": "https://studenten-gifts.vercel.app/api/mcp"
}
}
}Cline
{
"mcpServers": {
"studenten-gifts-mcp": {
"type": "streamableHttp",
"url": "https://studenten-gifts.vercel.app/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"studenten-gifts-mcp": {
"type": "http",
"url": "https://studenten-gifts.vercel.app/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http studenten-gifts-mcp https://studenten-gifts.vercel.app/api/mcpClaude Desktop
{
"mcpServers": {
"studenten-gifts-mcp": {
"url": "https://studenten-gifts.vercel.app/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"studenten-gifts-mcp": {
"serverUrl": "https://studenten-gifts.vercel.app/api/mcp"
}
}
}Let your agent find its tools
Find servers like Studenten Gifts MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.