Surprise Buddy
## What is Surprise Buddy? Surprise Buddy is a curated, country-scoped gift database exposed via a public Model Context Protocol (MCP) server. International coverage — every result 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. **Live MCP endpoint:** `https://www.surprise-buddy.com/api/mcp` ## Exposed tools - **`find_gifts`** — main search (country required, all other filters optional) - `list_supported_countries` - `list_supported_occasions(country?)` - `list_supported_interests` - `list_supported_colors` ## Authentication None — the MCP server is fully open. Reasonable rate limiting may apply. ## License [MIT](LICENSE) © Surprise Buddy
How to connect
https://mcp-server--surprise-buddy.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(5)-
find_giftsSearch the curated Surprise Buddy database for gift ideas matching a recipient. Returns product cards with title, image, price, why-it-fits, and a clickable product URL. Country is required and is a hard filter — results are scoped to the marketplace + currency of that country.
-
list_supported_countriesList ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time.
-
list_supported_occasionsList occasion codes that have active gift entries, optionally narrowed to a specific country.
-
list_supported_interestsList the canonical interest/hobby tag vocabulary used by find_gifts.interests. Matches the tags shown in the website UI.
-
list_supported_colorsList the canonical favorite-color vocabulary used by find_gifts.favorite_color. Matches the color picker shown in the website UI.