Surprise Buddy
What is Surprise Buddy?
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
- Find Gifts: Search 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 require
- List Supported Countries: List ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time.
- List Supported Occasions: List occasion codes that have active gift entries, optionally narrowed to a specific country.
What data it sees
Do you need an account
No: the server works without sign-in
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_countrieslist_supported_occasions(country?)list_supported_interestslist_supported_colors
Authentication
None — the MCP server is fully open. Reasonable rate limiting may apply.
License
MIT © Surprise Buddy
Server tool list (5)
Raw names from tools/list. Only developers need these.
| find_gifts | Search 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_countries | List ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time. |
| list_supported_occasions | List occasion codes that have active gift entries, optionally narrowed to a specific country. |
| list_supported_interests | List the canonical interest/hobby tag vocabulary used by find_gifts.interests. Matches the tags shown in the website UI. |
| list_supported_colors | List the canonical favorite-color vocabulary used by find_gifts.favorite_color. Matches the color picker shown in the website UI. |