Surprise Buddy

Surprise Buddy gift-搜索 技能

A live MCP HTTP server at https://www.surprise-buddy.com/API/mcp exposes a small 设置 of 工具s that 查询 a curated, country-scoped database of gift ideas. International coverage — every 结果 is a real product page on a real marketplace (Amazon, Etsy, Mercado Libre, Otto, Bol.com, Allegro, Jochen Schweizer) and the link can be presented to the user as-is.

Call 列出_supported_countries for the current 列出 of countries; coverage grows over time.

工具s find_gifts

MAIn 搜索. country is required and is a hard 过滤器 — 结果s never cross marketplaces.

arg type notes country string (ISO-2) required, e.g. DE, US, MX occasion string birthday, christmas, valentines, mothers-day, einschulung, sinterklaas, midsommar, … age integer recipient age gender male/female/unisex unisex rows always included bud获取_min_cents / bud获取_max_cents integer in country currency cents interests string[] hobby/interest tags — call 列出_supported_interests for the full 列出 profession string e.g. teacher, developer, chef, athlete, photographer, gamer favorite_color string one of red, blue, green, yellow, purple, pink, orange, black, white, gold, silver — only matches gifts whose favorite_color is exactly this; color-agnostic gifts are skipped when this 过滤器 is 设置 limit integer (1–20, default 5)

Returns { gifts: [ { id, title, description, why_it_fits, product_url, image_url, price, currency, shop, shop_display_name, category, favorite_color, country_code } ] }.

列出_supported_countries

Returns the country codes that currently have active entries.

列出_supported_occasions(country?)

Returns occasion codes with active entries, optionally narrowed to a country.

列出_supported_interests

Returns the canonical interest/hobby tag vocabulary (matches the tags shown in the 网页site UI).

列出_supported_colors

Returns the canonical favorite-color vocabulary (matches the color picker shown in the 网页site UI).

How to use it in a chat

When a user asks for gift help:

Pull country, occasion, age, bud获取, interests from the conversation (ask if any are missing — country is mandatory). Convert the bud获取 to cents in the country's currency, not a foreign currency. Call find_gifts. Render each gift as a card: title, image, price (with currency), why-it-fits, and a markdown link Buy on Amazon. Do not strip 查询 params from product_url — use the URL exactly as returned. Example User: "Geschenk für meinen 35-jährigen Bruder in Deutschland, mag Gaming, Bud获取 50-100€."

→ find_gifts({ country: "DE", age: 35, gender: "male", occasion: "birthday", bud获取_min_cents: 5000, bud获取_max_cents: 10000, interests: ["gaming"], limit: 5 })

What it is NOT Not a generic 网页 搜索 — only returns rows that exist in the curated DB. Not a price oracle — price_cents is the price at last verification, not live. Empty 结果s are valid: try widening the bud获取, removing gender, or dropping interests.